dotdo 0.0.1 → 0.1.0

package/cli/src/commands/config.ts

@@ -0,0 +1,115 @@
+/**
+ * Config Command
+ *
+ * Manage CLI configuration
+ *
+ * Usage:
+ *   do config get                    # Show all config
+ *   do config get api_url            # Show specific config value
+ *   do config set json_output true   # Set config value
+ *   do config unset api_url          # Remove config value
+ *   do config list                   # List available config keys
+ */
+
+import { parseArgs, requirePositional } from '../args'
+import { getConfig, setConfig, unsetConfig, defaultConfig, configKeys, isValidConfigKey, parseConfigValue, type Config, type ConfigKey } from '../config'
+import { formatJson, formatTable } from '../output'
+
+// ============================================================================
+// Subcommands
+// ============================================================================
+
+async function get(rawArgs: string[]): Promise<void> {
+  const args = parseArgs(rawArgs)
+  const key = args.positional[0] as ConfigKey | undefined
+
+  const config = await getConfig()
+
+  if (key) {
+    if (!isValidConfigKey(key)) {
+      throw new Error(`Unknown config key: ${key}. Run 'do config list' to see available keys.`)
+    }
+    const value = config[key] ?? defaultConfig[key as keyof typeof defaultConfig]
+    console.log(value)
+  } else {
+    // Show all config
+    console.log(formatJson(config, { pretty: true }))
+  }
+}
+
+async function set(rawArgs: string[]): Promise<void> {
+  const args = parseArgs(rawArgs)
+
+  const key = requirePositional(args, 0, 'config key')
+  const valueStr = requirePositional(args, 1, 'config value')
+
+  if (!isValidConfigKey(key)) {
+    throw new Error(`Unknown config key: ${key}. Run 'do config list' to see available keys.`)
+  }
+
+  const value = parseConfigValue(key, valueStr)
+  await setConfig({ [key]: value } as Partial<Config>)
+
+  console.log(`Set ${key} = ${JSON.stringify(value)}`)
+}
+
+async function unset(rawArgs: string[]): Promise<void> {
+  const args = parseArgs(rawArgs)
+
+  const key = requirePositional(args, 0, 'config key')
+
+  if (!isValidConfigKey(key)) {
+    throw new Error(`Unknown config key: ${key}. Run 'do config list' to see available keys.`)
+  }
+
+  await unsetConfig(key)
+  console.log(`Unset ${key}`)
+}
+
+async function list(_rawArgs: string[]): Promise<void> {
+  const descriptions: Record<ConfigKey, string> = {
+    api_url: 'Base API URL for rpc.do gateway',
+    json_output: 'Output JSON instead of human-readable format',
+    default_model: 'Default LLM model for llm command',
+    default_from: 'Default sender for calls/texts',
+    default_email_from: 'Default email sender',
+    default_currency: 'Default currency for charges',
+    custom_headers: 'Custom headers to include in all requests',
+  }
+
+  for (const key of configKeys) {
+    const desc = descriptions[key]
+    const defaultValue = defaultConfig[key as keyof typeof defaultConfig]
+    console.log(`${key}`)
+    console.log(`  ${desc}`)
+    if (defaultValue !== undefined) {
+      console.log(`  Default: ${JSON.stringify(defaultValue)}`)
+    }
+    console.log('')
+  }
+}
+
+// ============================================================================
+// Command Router
+// ============================================================================
+
+export async function run(rawArgs: string[]): Promise<void> {
+  const [subcommand, ...restArgs] = rawArgs
+
+  switch (subcommand) {
+    case 'get':
+      return get(restArgs)
+    case 'set':
+      return set(restArgs)
+    case 'unset':
+      return unset(restArgs)
+    case 'list':
+      return list(restArgs)
+    default:
+      if (!subcommand) {
+        // Default to get (show all config)
+        return get([])
+      }
+      throw new Error(`Unknown subcommand: ${subcommand}. Available: get, set, unset, list`)
+  }
+}

package/cli/src/commands/email.ts

@@ -0,0 +1,112 @@
+/**
+ * Email Command
+ *
+ * Send emails via emails.do
+ *
+ * Usage:
+ *   do email user@example.com --subject "Hello" --body "Hi there!"
+ *   do email user@example.com --template welcome
+ *   do email user@example.com --subject "Hi" --html "<h1>Hello</h1>"
+ *   do email user@example.com --subject "Hi" --from noreply@company.com
+ *   do email user@example.com --template welcome --json
+ */
+
+import { parseArgs, requirePositional, getStringFlag, getBooleanFlag, isValidEmail } from '../args'
+import { emailsRequest } from '../rpc'
+import { formatJson } from '../output'
+import { getConfig } from '../config'
+
+// ============================================================================
+// Types
+// ============================================================================
+
+interface EmailRequest {
+  to: string
+  from?: string
+  subject?: string
+  text?: string
+  html?: string
+  template?: string
+  variables?: Record<string, unknown>
+}
+
+interface EmailResponse {
+  email_id: string
+  status: string
+}
+
+// ============================================================================
+// Command
+// ============================================================================
+
+export async function run(rawArgs: string[]): Promise<void> {
+  const args = parseArgs(rawArgs)
+
+  // Validate required arguments
+  const to = requirePositional(args, 0, 'email address')
+
+  if (!isValidEmail(to)) {
+    throw new Error(`Invalid email address format`)
+  }
+
+  // Build request
+  const request: EmailRequest = {
+    to,
+  }
+
+  const from = getStringFlag(args, 'from')
+  if (from) {
+    if (!isValidEmail(from)) {
+      throw new Error(`Invalid --from email address format`)
+    }
+    request.from = from
+  }
+
+  const subject = getStringFlag(args, 'subject')
+  if (subject) {
+    request.subject = subject
+  }
+
+  const body = getStringFlag(args, 'body')
+  if (body) {
+    request.text = body
+  }
+
+  const html = getStringFlag(args, 'html')
+  if (html) {
+    request.html = html
+  }
+
+  const template = getStringFlag(args, 'template')
+  if (template) {
+    request.template = template
+  }
+
+  const variables = getStringFlag(args, 'variables')
+  if (variables) {
+    try {
+      request.variables = JSON.parse(variables)
+    } catch {
+      throw new Error(`Invalid --variables: expected valid JSON`)
+    }
+  }
+
+  // Make request
+  const response = await emailsRequest<EmailResponse>('/emails', {
+    method: 'POST',
+    body: request,
+  })
+
+  // Output result
+  const config = await getConfig()
+  const jsonOutput = getBooleanFlag(args, 'json') || config.json_output
+
+  if (jsonOutput) {
+    console.log(formatJson(response))
+  } else {
+    console.log(`Email sent: ${response.email_id}`)
+    if (response.status) {
+      console.log(`Status: ${response.status}`)
+    }
+  }
+}

package/cli/src/commands/llm.ts

@@ -0,0 +1,115 @@
+/**
+ * LLM Command
+ *
+ * Make LLM requests via llm.do (with streaming)
+ *
+ * Usage:
+ *   do llm "Summarize this document"
+ *   do llm "Hello" --model claude-sonnet
+ *   do llm "Hello" --system "You are a helpful assistant"
+ *   do llm "Hello" --max-tokens 100
+ *   do llm "Hello" --temperature 0.7
+ *   do llm "Hello" --no-stream
+ *   do llm "Hello" --json
+ */
+
+import { parseArgs, requirePositional, getStringFlag, getBooleanFlag, getNumberFlag } from '../args'
+import { llmRequest } from '../rpc'
+import { formatJson, parseSSEStream } from '../output'
+import { getConfig } from '../config'
+
+// ============================================================================
+// Types
+// ============================================================================
+
+interface LLMRequest {
+  prompt: string
+  model?: string
+  system?: string
+  max_tokens?: number
+  temperature?: number
+  stream?: boolean
+}
+
+interface LLMResponse {
+  response: string
+  model?: string
+  usage?: {
+    prompt_tokens: number
+    completion_tokens: number
+    total_tokens: number
+  }
+}
+
+// ============================================================================
+// Command
+// ============================================================================
+
+export async function run(rawArgs: string[]): Promise<void> {
+  const args = parseArgs(rawArgs)
+
+  // Validate required arguments
+  const prompt = requirePositional(args, 0, 'prompt')
+
+  // Build request
+  const config = await getConfig()
+  // --no-stream sets flags['stream'] = false, so check for that
+  const streamFlag = args.flags['stream']
+  const stream = streamFlag !== false
+
+  const request: LLMRequest = {
+    prompt,
+    stream,
+  }
+
+  const model = getStringFlag(args, 'model') ?? config.default_model
+  if (model) {
+    request.model = model
+  }
+
+  const system = getStringFlag(args, 'system')
+  if (system) {
+    request.system = system
+  }
+
+  const maxTokens = getNumberFlag(args, 'max-tokens')
+  if (maxTokens !== undefined) {
+    request.max_tokens = maxTokens
+  }
+
+  const temperature = getNumberFlag(args, 'temperature')
+  if (temperature !== undefined) {
+    request.temperature = temperature
+  }
+
+  // Handle streaming
+  if (stream) {
+    const responseStream = await llmRequest<ReadableStream<Uint8Array>>('/completions', {
+      method: 'POST',
+      body: request,
+      stream: true,
+    })
+
+    // Stream output to stdout
+    for await (const chunk of parseSSEStream(responseStream)) {
+      process.stdout.write(chunk)
+    }
+    process.stdout.write('\n')
+    return
+  }
+
+  // Non-streaming request
+  const response = await llmRequest<LLMResponse>('/completions', {
+    method: 'POST',
+    body: request,
+  })
+
+  // Output result
+  const jsonOutput = getBooleanFlag(args, 'json') || config.json_output
+
+  if (jsonOutput) {
+    console.log(formatJson(response))
+  } else {
+    console.log(response.response)
+  }
+}

package/cli/src/commands/queue.ts

@@ -0,0 +1,134 @@
+/**
+ * Queue Command
+ *
+ * Queue operations via queue.do
+ *
+ * Usage:
+ *   do queue publish my-queue '{"event": "user.signup"}'
+ *   do queue publish my-queue '{}' --delay 60
+ *   do queue publish my-queue '<xml>data</xml>' --content-type application/xml
+ *   do queue list
+ *   do queue list --json
+ */
+
+import { parseArgs, requirePositional, getStringFlag, getBooleanFlag, getNumberFlag } from '../args'
+import { queueRequest } from '../rpc'
+import { formatJson, formatTable } from '../output'
+import { getConfig } from '../config'
+
+// ============================================================================
+// Types
+// ============================================================================
+
+interface PublishResponse {
+  message_id: string
+  status: string
+}
+
+interface QueueInfo {
+  name: string
+  messages: number
+  consumers?: number
+}
+
+interface ListQueuesResponse {
+  queues: QueueInfo[]
+}
+
+// ============================================================================
+// Subcommands
+// ============================================================================
+
+async function publish(rawArgs: string[]): Promise<void> {
+  const args = parseArgs(rawArgs)
+
+  // Validate required arguments
+  const queueName = requirePositional(args, 0, 'queue name')
+  const messageBody = requirePositional(args, 1, 'message body')
+
+  // Parse message body
+  let body: unknown
+  const contentType = getStringFlag(args, 'content-type') ?? 'application/json'
+
+  if (contentType === 'application/json') {
+    try {
+      body = JSON.parse(messageBody)
+    } catch {
+      throw new Error(`Invalid message body: expected valid JSON`)
+    }
+  } else {
+    body = messageBody
+  }
+
+  // Build headers
+  const headers: Record<string, string> = {
+    'Content-Type': contentType,
+  }
+
+  const delay = getNumberFlag(args, 'delay')
+  if (delay !== undefined) {
+    headers['X-Delay'] = String(delay)
+  }
+
+  // Make request
+  const response = await queueRequest<PublishResponse>(`/queues/${encodeURIComponent(queueName)}/messages`, {
+    method: 'POST',
+    body,
+    headers,
+  })
+
+  // Output result
+  const config = await getConfig()
+  const jsonOutput = getBooleanFlag(args, 'json') || config.json_output
+
+  if (jsonOutput) {
+    console.log(formatJson(response))
+  } else {
+    console.log(`Message published: ${response.message_id}`)
+    if (response.status) {
+      console.log(`Status: ${response.status}`)
+    }
+  }
+}
+
+async function list(rawArgs: string[]): Promise<void> {
+  const args = parseArgs(rawArgs)
+
+  // Make request
+  const response = await queueRequest<ListQueuesResponse>('/queues', {
+    method: 'GET',
+  })
+
+  // Output result
+  const config = await getConfig()
+  const jsonOutput = getBooleanFlag(args, 'json') || config.json_output
+
+  if (jsonOutput) {
+    console.log(formatJson(response))
+  } else if (response.queues.length === 0) {
+    console.log('No queues found')
+  } else {
+    // Cast to Record<string, unknown>[] for formatTable
+    console.log(formatTable(response.queues as unknown as Record<string, unknown>[]))
+  }
+}
+
+// ============================================================================
+// Command Router
+// ============================================================================
+
+export async function run(rawArgs: string[]): Promise<void> {
+  const [subcommand, ...restArgs] = rawArgs
+
+  switch (subcommand) {
+    case 'publish':
+      return publish(restArgs)
+    case 'list':
+      return list(restArgs)
+    default:
+      if (!subcommand) {
+        throw new Error(`Missing subcommand. Usage: do queue <publish|list>`)
+      }
+      throw new Error(`Unknown subcommand: ${subcommand}. Available: publish, list`)
+  }
+}

package/cli/src/commands/text.ts

@@ -0,0 +1,86 @@
+/**
+ * Text Command
+ *
+ * Send SMS/MMS via texts.do
+ *
+ * Usage:
+ *   do text +15551234567 "Reply YES to confirm"
+ *   do text +15551234567 "Hello" --from +15559876543
+ *   do text +15551234567 "Check this out" --media-url https://example.com/image.jpg
+ *   do text +15551234567 "Hello" --json
+ */
+
+import { parseArgs, requirePositional, getStringFlag, getBooleanFlag, isValidPhoneNumber } from '../args'
+import { textsRequest } from '../rpc'
+import { formatJson } from '../output'
+import { getConfig } from '../config'
+
+// ============================================================================
+// Types
+// ============================================================================
+
+interface TextRequest {
+  to: string
+  body: string
+  from?: string
+  media_url?: string
+}
+
+interface TextResponse {
+  message_id: string
+  status: string
+}
+
+// ============================================================================
+// Command
+// ============================================================================
+
+export async function run(rawArgs: string[]): Promise<void> {
+  const args = parseArgs(rawArgs)
+
+  // Validate required arguments
+  const to = requirePositional(args, 0, 'phone number')
+  const body = requirePositional(args, 1, 'message')
+
+  if (!isValidPhoneNumber(to)) {
+    throw new Error(`Invalid phone number format. Use E.164 format (e.g., +15551234567)`)
+  }
+
+  // Build request
+  const request: TextRequest = {
+    to,
+    body,
+  }
+
+  const from = getStringFlag(args, 'from')
+  if (from) {
+    if (!isValidPhoneNumber(from)) {
+      throw new Error(`Invalid --from phone number format. Use E.164 format (e.g., +15551234567)`)
+    }
+    request.from = from
+  }
+
+  const mediaUrl = getStringFlag(args, 'media-url')
+  if (mediaUrl) {
+    request.media_url = mediaUrl
+  }
+
+  // Make request
+  const response = await textsRequest<TextResponse>('/messages', {
+    method: 'POST',
+    body: request,
+  })
+
+  // Output result
+  const config = await getConfig()
+  const jsonOutput = getBooleanFlag(args, 'json') || config.json_output
+
+  if (jsonOutput) {
+    console.log(formatJson(response))
+  } else {
+    console.log(`Message sent: ${response.message_id}`)
+    if (response.status) {
+      console.log(`Status: ${response.status}`)
+    }
+  }
+}