luca 3.0.0 → 3.1.0

package/commands/social.ts

@@ -0,0 +1,137 @@
+import { z } from 'zod'
+import { CommandOptionsSchema } from 'luca'
+import type { ContainerContext } from 'luca'
+
+export const argsSchema = CommandOptionsSchema.extend({
+  name: z.string().default('luca-agent').describe('Agent name / identity to use'),
+  bootstrap: z.string().optional().describe('JSON NodeAddr from another agent — enables immediate gossip connectivity'),
+  file: z.string().optional().describe('Path to a file to send as a blob attachment'),
+  mesh: z.string().optional().describe('Private mesh ID — all agents must use the same value to communicate'),
+  subcommand: z.string().optional().describe('Subcommand: whoami | listen | send'),
+  arg1: z.string().optional().describe('First positional argument'),
+  arg2: z.string().optional().describe('Second positional argument'),
+})
+
+export const positionals = ['subcommand', 'arg1', 'arg2']
+
+const USAGE = `
+Usage:
+  luca social whoami [--name <name>] [--mesh <id>]                                  Print this agent's identity
+  luca social listen [--name <name>] [--mesh <id>]                                  Join the mesh and print incoming messages
+  luca social send <pubkey> <msg> [--name <name>] [--mesh <id>]                     Send an encrypted message
+  luca social send <pubkey> --file <path> [--name <name>] [--mesh <id>]             Send a file
+  luca social send <pubkey> --file <path> <caption> [--name <name>] [--mesh <id>]   Send a file with caption
+
+  --mesh <id>   Private mesh ID. All agents must use the same value.
+                Omit to use the public Cipher topic (interop with Cipher desktop app).
+`.trim()
+
+export async function social(options: z.infer<typeof argsSchema>, context: ContainerContext) {
+  const container = context.container as any
+  const ui = container.feature('ui')
+  const subcommand = options.subcommand
+
+  if (!subcommand || subcommand === 'help') {
+    ui.print(USAGE)
+    return
+  }
+
+  await container.helpers.discoverAll()
+  const bootstrapAddrs = options.bootstrap ? [options.bootstrap] : []
+  const agent = container.feature('cipherSocial', { name: options.name, bootstrapAddrs, meshId: options.mesh })
+
+  if (subcommand === 'whoami') {
+    await agent.loadIdentity()
+    ui.print(`Name:       ${options.name}`)
+    ui.print(`Public Key: ${agent.publicKey}`)
+    ui.print(`Data dir:   ${agent.dataDir}`)
+    return
+  }
+
+  if (subcommand === 'listen') {
+    ui.print(`Connecting as "${options.name}"...`)
+    await agent.connect()
+    ui.print(`Connected`)
+    ui.print(`Node ID:    ${agent.nodeId}`)
+    ui.print(`Public Key: ${agent.publicKey}`)
+    ui.print(`\nTo send to this agent from another machine:`)
+    ui.print(`  luca social send '${agent.publicKey}' 'hello' --bootstrap '${agent.nodeAddrJson}'`)
+    ui.print(`\nListening for messages. Ctrl+C to exit.\n`)
+
+    agent.on('presence', ({ publicKey, name }: any) => {
+      ui.print(`[presence] ${name} (${publicKey.slice(0, 12)}...)`)
+    })
+
+    agent.on('message', async ({ from, payload }: any) => {
+      const fromShort = from.slice(0, 12) + '...'
+
+      if (payload?.type === 'file') {
+        const outPath = `downloads/${payload.filename}`
+        ui.print(`\n[file from ${fromShort}] ${payload.filename} (${(payload.size / 1024).toFixed(1)} KB)`)
+        if (payload.caption) ui.print(`  caption: ${payload.caption}`)
+        ui.print(`  fetching blob...`)
+        try {
+          await agent.fetchBlobToFile(payload.blobHash, payload.blobNodeAddr, outPath)
+          ui.print(`  saved to ${outPath}`)
+        } catch (err: any) {
+          ui.print(`  fetch failed: ${err.message}`)
+        }
+        return
+      }
+
+      ui.print(`\n[message from ${fromShort}]`)
+      ui.print(JSON.stringify(payload, null, 2))
+    })
+
+    process.on('SIGINT', async () => {
+      await agent.disconnect()
+      process.exit(0)
+    })
+
+    await new Promise(() => {})
+    return
+  }
+
+  if (subcommand === 'send') {
+    const recipientKey = options.arg1
+
+    if (!recipientKey) {
+      ui.print('Usage: luca social send <public-key> <message>')
+      ui.print('       luca social send <public-key> --file <path>')
+      process.exit(1)
+    }
+
+    ui.print(`Connecting as "${options.name}"...`)
+    await agent.connect()
+
+    if (options.file) {
+      ui.print(`Storing file ${options.file}...`)
+      ui.print(`Sending file to ${recipientKey.slice(0, 12)}...`)
+      await agent.sendFile(recipientKey, options.file, options.arg2)
+    } else {
+      const message = options.arg2
+      if (!message) {
+        ui.print('Usage: luca social send <public-key> <message>')
+        await agent.disconnect()
+        process.exit(1)
+      }
+      ui.print(`Sending to ${recipientKey.slice(0, 12)}...`)
+      await agent.send(recipientKey, { type: 'text', text: message })
+    }
+
+    // Wait for gossip broadcast to propagate
+    await new Promise(resolve => setTimeout(resolve, 3000))
+    await agent.disconnect()
+    ui.print('Sent.')
+    return
+  }
+
+  ui.print(`Unknown subcommand: ${subcommand}`)
+  ui.print(USAGE)
+}
+
+export default {
+  description: 'Encrypted P2P messaging between Luca agents via the Cipher social network.',
+  argsSchema,
+  handler: social,
+}

package/commands/try-all-challenges.ts

@@ -1,8 +1,8 @@
 import { z } from 'zod'
-import { commands, CommandOptionsSchema } from '@soederpop/luca'
-import type { ContainerContext } from '@soederpop/luca'
+import { commands, CommandOptionsSchema } from 'luca'
+import type { ContainerContext } from 'luca'
 
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableCommands {
     tryAllChallenges: ReturnType<typeof commands.registerHandler>
   }

package/commands/try-challenge.ts

@@ -1,8 +1,8 @@
 import { z } from 'zod'
-import { commands, CommandOptionsSchema } from '@soederpop/luca'
-import type { ContainerContext } from '@soederpop/luca'
+import { commands, CommandOptionsSchema } from 'luca'
+import type { ContainerContext } from 'luca'
 
-declare module '@soederpop/luca' {
+declare module 'luca' {
   interface AvailableCommands {
     tryChallenge: ReturnType<typeof commands.registerHandler>
   }