@koi-language/koi 1.0.5 → 1.1.0

package/examples/directory-import-test.koi

@@ -1,84 +0,0 @@
-// ============================================================
-// Directory Import Test
-// Tests importing from directories (looks for index.koi)
-// ============================================================
-
-package "demo.koi.directory"
-
-// Import from directory - automatically finds index.koi
-import "./skills/advanced"
-
-role Worker { can work }
-
-// Agent that uses skills from the directory import
-Agent StatisticsProcessor : Worker {
-  llm default = { provider: "openai", model: "gpt-4o-mini", temperature: 0.1, max_tokens: 300 }
-  uses Skill StatisticalAnalysis
-
-  on process(args: Json) {
-    playbook """
-    Process statistical analysis for: ${JSON.stringify(args)}
-
-    Pass the "numbers" array to the tool and return the result.
-    """
-  }
-}
-
-Team WorkerTeam {
-  processor = StatisticsProcessor
-  analyzer = DataAnalyzer  // Agent from the imported directory
-}
-
-// Demo runner
-Agent DemoRunner : Worker {
-  uses Team WorkerTeam
-
-  on runTest(args: Json) {
-    console.log("╔════════════════════════════════════════════╗")
-    console.log("║  Directory Import Test                     ║")
-    console.log("║  import \"./skills/advanced\"                ║")
-    console.log("╚════════════════════════════════════════════╝\n")
-
-    // Test 1: Calculate mean using skill directly
-    console.log("📋 Test 1: Calculate mean of [10, 20, 30, 40, 50]")
-    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")
-
-    const meanResult =
-      await send peers.event("process").role(Worker).any()({
-        operation: "mean",
-        numbers: [10, 20, 30, 40, 50]
-      }) timeout 10s
-
-    console.log("Result:", JSON.stringify(meanResult, null, 2))
-
-    // Test 2: Calculate median
-    console.log("\n📋 Test 2: Calculate median of [1, 3, 5, 7, 9, 11]")
-    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")
-
-    const medianResult =
-      await send peers.event("process").role(Worker).any()({
-        operation: "median",
-        numbers: [1, 3, 5, 7, 9, 11]
-      }) timeout 10s
-
-    console.log("Result:", JSON.stringify(medianResult, null, 2))
-
-    // Test 3: Use the imported DataAnalyzer agent
-    console.log("\n📋 Test 3: Full analysis using DataAnalyzer agent!!!!")
-    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")
-
-    const analysisResult =
-      await send peers.event("analyze").role(DataScientist).any()({
-        numbers: [15, 25, 35, 45, 55, 65, 75]
-      }) timeout 10s
-
-    console.log("Result:", JSON.stringify(analysisResult, null, 2))
-
-    return {
-      success: true,
-      tests_completed: 3
-    }
-  }
-}
-
-run DemoRunner.runTest({})

package/examples/hello-world-claude.koi

@@ -1,52 +0,0 @@
-// ============================================================
-// Koi — Hello World with Claude
-// Using Anthropic's Claude instead of OpenAI
-// ============================================================
-
-package "demo.koi.helloworld.claude"
-
-role Worker { can execute }
-
-// Agent with playbook using Claude
-Agent Greeter : Worker {
-  llm default = { provider: "anthropic", model: "claude-3-5-haiku-20241022", temperature: 0.7, max_tokens: 200 }
-
-  on greet(args: Json) {
-    playbook """
-    You are a friendly greeter. Generate a warm, creative greeting for the person whose name is in args.name.
-
-    Return a JSON object with this exact structure:
-    {
-      "greeting": "Your creative greeting here",
-      "language": "english",
-      "style": "friendly"
-    }
-
-    Make the greeting unique and warm, but keep it under 50 words.
-    """
-  }
-}
-
-Team HelloTeam {
-  greeter = Greeter
-}
-
-// Orchestrator with procedural code
-Agent Orchestrator : Worker {
-  uses Team HelloTeam
-
-  on start(args: Json) {
-    const name = args.name
-
-    const result =
-      await send peers.event("greet").role(Worker).any()({ name: name }) timeout 30s
-
-    return {
-      success: true,
-      name: name,
-      response: result
-    }
-  }
-}
-
-run Orchestrator.start({ name: "World" })

package/examples/hello.koi

@@ -1,24 +0,0 @@
-// Minimal test
-package "test"
-
-role Worker { can execute }
-
-Agent Test : Worker {
-on test(args: Json) {
-return { ok: true }
-}
-}
-
-Team T {
-t = Test
-}
-
-Agent Orch : Worker {
-uses Team T
-on start(args: Json) {
-const r = await send peers.event("test").role(Worker).any()({}) timeout 2s
-return r
-}
-}
-
-run Orch.start({})

package/examples/mcp-example.koi

@@ -1,70 +0,0 @@
-// ============================================================
-// Koi — MCP (Model Context Protocol) Example
-// Demonstrates using MCP addresses to reference remote agents
-// ============================================================
-
-package "demo.koi.mcp"
-
-role Worker { can execute }
-role Lead   { can delegate }
-
-// Local agent
-Agent LocalProcessor : Worker {
-  on process(args: Json) {
-    const data = args.data
-    const processed = "LOCAL: " + data
-    return { result: processed, source: "local" }
-  }
-}
-
-// Team with both local and remote (MCP) agents
-Team HybridTeam {
-  // Regular local agent
-  local = LocalProcessor
-
-  // Remote agents via MCP addresses
-  // Format: mcp://server/path
-  remote1 = mcp://agent.local/processor
-  remote2 = mcp://service.local/analyzer
-}
-
-// Orchestrator that uses both local and remote agents
-Agent Orchestrator : Lead {
-  uses Team HybridTeam
-
-  on start(args: Json) {
-    const data = args.data
-
-    // This will try local first, then MCP agents
-    const result =
-      await send peers.event("process").role(Worker).any()({ data: data }) timeout 10s
-
-    return {
-      success: true,
-      result: result
-    }
-  }
-
-  on processAll(args: Json) {
-    const data = args.data
-
-    // Process with ALL agents (local + MCP)
-    const results =
-      await send peers.event("process").role(Worker).all()({ data: data }) timeout 15s
-
-    return {
-      success: true,
-      count: 3,
-      results: results
-    }
-  }
-}
-
-// Example with MCP skill reference
-Team DistributedTeam {
-  orchestrator = Orchestrator
-  // Reference a remote skill
-  sentiment = mcp://skills.local/sentiment-analysis
-}
-
-run Orchestrator.start({ data: "Hello from Koi with MCP support!" })

package/examples/new-import-test.koi

@@ -1,89 +0,0 @@
-// ============================================================
-// New Import System Test
-// Tests the new simplified import syntax
-// ============================================================
-
-package "demo.koi.new.import"
-
-// New import syntax - imports everything (Skills, Agents, Roles, Teams)
-import "./skills/math-operations.koi"
-import "@koi-lang/common-skills"
-
-role Worker { can work }
-
-// Agent that uses imported skills from both local and npm package
-Agent DataProcessor : Worker {
-  llm default = { provider: "openai", model: "gpt-4o-mini", temperature: 0.1, max_tokens: 300 }
-  // Comma-separated syntax (cleaner!)
-  uses Skill MathOperations, DataValidation, DataTransformation
-
-  on process(args: Json) {
-    playbook """
-    Process the request: ${JSON.stringify(args)}
-
-    Use the available tools (math, validation, transformation) to complete the task.
-    Return the result as JSON.
-    """
-  }
-}
-
-Team WorkerTeam {
-  processor = DataProcessor
-  // Also use the imported EmailValidator agent
-  emailValidator = EmailValidator
-}
-
-// Demo runner
-Agent DemoRunner : Worker {
-  uses Team WorkerTeam
-
-  on runTest(args: Json) {
-    console.log("╔════════════════════════════════════════════╗")
-    console.log("║  New Import System Test                    ║")
-    console.log("║  Local files + npm packages                ║")
-    console.log("╚════════════════════════════════════════════╝\n")
-
-    // Test 1: Use local skill (math)
-    console.log("📋 Test 1: Math operation from local skill")
-    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")
-
-    const mathResult =
-      await send peers.event("process").role(Worker).any()({
-        operation: "add",
-        a: 15,
-        b: 27
-      }) timeout 10s
-
-    console.log("Result:", JSON.stringify(mathResult, null, 2))
-
-    // Test 2: Use npm package skill (validation)
-    console.log("\n📋 Test 2: Email validation from npm package")
-    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")
-
-    const validationResult =
-      await send peers.event("process").role(Worker).any()({
-        operation: "validateEmail",
-        email: "test@example.com"
-      }) timeout 10s
-
-    console.log("Result:", JSON.stringify(validationResult, null, 2))
-
-    // Test 3: Use imported agent directly
-    console.log("\n📋 Test 3: Using imported EmailValidator agent")
-    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")
-
-    const agentResult =
-      await send peers.event("validate").role(Validator).any()({
-        email: "invalid-email"
-      }) timeout 10s
-
-    console.log("Result:", JSON.stringify(agentResult, null, 2))
-
-    return {
-      success: true,
-      tests_completed: 3
-    }
-  }
-}
-
-run DemoRunner.runTest({})

package/examples/registry-demo.koi

@@ -1,184 +0,0 @@
-// Registry Demo - Shared data store between agents
-package "registry.demo"
-
-role Worker { can execute }
-
-// Agent that writes data to the registry
-Agent Writer : Worker {
-  on saveUser(args: Json) {
-    const userId = args.id
-    const userData = {
-      name: args.name,
-      age: args.age,
-      email: args.email,
-      createdAt: Date.now()
-    }
-
-    await registry.set("user:" + userId, userData)
-
-    console.log("✅ Saved user:", userId)
-    return { saved: true, userId: userId }
-  }
-
-  on saveConfig(args: Json) {
-    await registry.set("config:app", {
-      theme: args.theme || "dark",
-      language: args.language || "en",
-      notifications: args.notifications !== false
-    })
-
-    console.log("✅ Saved config")
-    return { saved: true }
-  }
-}
-
-// Agent that reads data from the registry
-Agent Reader : Worker {
-  on getUser(args: Json) {
-    const userId = args.id
-    const user = await registry.get("user:" + userId)
-
-    if (!user) {
-      console.log("❌ User not found:", userId)
-      return { found: false, userId: userId }
-    }
-
-    console.log("📖 Retrieved user:", user.name)
-    return { found: true, user: user }
-  }
-
-  on getConfig(args: Json) {
-    const config = await registry.get("config:app")
-
-    if (!config) {
-      console.log("⚙️  No config found, using defaults")
-      return { found: false, config: null }
-    }
-
-    console.log("⚙️  Retrieved config:", JSON.stringify(config))
-    return { found: true, config: config }
-  }
-
-  on listUsers(args: Json) {
-    const userKeys = await registry.keys("user:")
-    console.log("📋 Found", userKeys.length, "users")
-
-    const users = []
-    for (const key of userKeys) {
-      const user = await registry.get(key)
-      users.push({ id: key.replace("user:", ""), ...user })
-    }
-
-    return { count: users.length, users: users }
-  }
-}
-
-// Agent that searches the registry
-Agent Searcher : Worker {
-  on findAdults(args: Json) {
-    const results = await registry.search({
-      age: { $gte: 18 }
-    })
-
-    console.log("🔍 Found", results.length, "adults")
-
-    const adults = results.map(r => ({
-      id: r.key.replace("user:", ""),
-      ...r.value
-    }))
-
-    return { count: adults.length, adults: adults }
-  }
-
-  on findByName(args: Json) {
-    const results = await registry.search({
-      name: { $regex: args.pattern }
-    })
-
-    console.log("🔍 Found", results.length, "matching users")
-
-    const matches = results.map(r => ({
-      id: r.key.replace("user:", ""),
-      ...r.value
-    }))
-
-    return { count: matches.length, matches: matches }
-  }
-}
-
-// Orchestrator that coordinates the demo
-Agent Demo : Worker {
-  on start(args: Json) {
-    console.log("═════════════════════════════════════════════")
-    console.log("  Registry Demo - Shared Data Store")
-    console.log("═════════════════════════════════════════════")
-    console.log("")
-
-    // 1. Save some users
-    console.log("1️⃣  Saving users...")
-    await Writer.handle("saveUser", { id: "001", name: "Alice", age: 30, email: "alice@example.com" })
-    await Writer.handle("saveUser", { id: "002", name: "Bob", age: 25, email: "bob@example.com" })
-    await Writer.handle("saveUser", { id: "003", name: "Charlie", age: 17, email: "charlie@example.com" })
-    await Writer.handle("saveUser", { id: "004", name: "Diana", age: 35, email: "diana@example.com" })
-    console.log("")
-
-    // 2. Save config
-    console.log("2️⃣  Saving config...")
-    await Writer.handle("saveConfig", { theme: "light", language: "es", notifications: true })
-    console.log("")
-
-    // 3. Read individual user
-    console.log("3️⃣  Reading user...")
-    const userResult = await Reader.handle("getUser", { id: "001" })
-    console.log("   User:", JSON.stringify(userResult.user, null, 2))
-    console.log("")
-
-    // 4. Read config
-    console.log("4️⃣  Reading config...")
-    const configResult = await Reader.handle("getConfig", {})
-    console.log("   Config:", JSON.stringify(configResult.config, null, 2))
-    console.log("")
-
-    // 5. List all users
-    console.log("5️⃣  Listing all users...")
-    const listResult = await Reader.handle("listUsers", {})
-    for (const user of listResult.users) {
-      console.log("   -", user.name, "(" + user.age + " years old)")
-    }
-    console.log("")
-
-    // 6. Search for adults
-    console.log("6️⃣  Searching for adults (age >= 18)...")
-    const adultsResult = await Searcher.handle("findAdults", {})
-    for (const adult of adultsResult.adults) {
-      console.log("   -", adult.name, "(" + adult.age + " years old)")
-    }
-    console.log("")
-
-    // 7. Search by name pattern
-    console.log("7️⃣  Searching for names containing 'a'...")
-    const searchResult = await Searcher.handle("findByName", { pattern: "a" })
-    for (const match of searchResult.matches) {
-      console.log("   -", match.name)
-    }
-    console.log("")
-
-    // 8. Show stats
-    console.log("8️⃣  Registry stats...")
-    const stats = await registry.stats()
-    console.log("   Backend:", stats.backend)
-    console.log("   Entries:", stats.count)
-    console.log("   File:", stats.file)
-    console.log("   Size:", stats.size, "bytes")
-    console.log("")
-
-    console.log("═════════════════════════════════════════════")
-    console.log("  Demo Complete!")
-    console.log("  Data persisted to:", stats.file)
-    console.log("═════════════════════════════════════════════")
-
-    return { success: true }
-  }
-}
-
-run Demo.start({})

package/examples/registry-playbook-email-compositor-2.koi

@@ -1,140 +0,0 @@
-// Registry with Natural Language Playbooks Demo
-// Shows how agents can use registry operations naturally in playbooks
-package "registry.playbook.demo"
-
-role Worker { can execute, can registry }
-role Manager { can execute, can delegate }
-
-// Agent that uses natural language to interact with registry
-Agent UserManager : Worker {
-  llm default = { provider: "openai", model: "gpt-4o-mini" }
-
-  on createUser(args: Json) {
-    playbook """
-    Create a new user with ALL fields from args:
-    - name: ${args.name}
-    - age: ${args.age}
-    - email: ${args.email}
-    - birthdate: ${args.birthdate} (if provided)
-    - id: ${args.id}
-
-    Save to registry with key "user:${args.id}".
-    CRITICAL: Include ALL fields from args (name, age, email, birthdate, id) plus a createdAt timestamp.
-    Return: { "success": true, "message": "User created" }
-
-    DO NOT add print actions - just return the data.
-    """
-  }
-
-  on getUser(args: Json) {
-    playbook """
-    Get user ${args.id} from registry.
-
-    Use registry_get with key "user:${args.id}".
-    Extract the .value field from the registry_get result (which contains the user data).
-    Return ONLY the user data object (name, age, email, createdAt) without any wrapper.
-    """
-  }
-
-  on listAllUsers(args: Json) {
-    playbook """
-    List all users in the registry.
-
-    EXACT STEPS:
-    1. Use registry_search with an empty query {} to get ALL users, store with ID "a1"
-    2. Extract just the user data (the .value field) from each result
-    3. Return: { "count": <count from a1>, "users": <array of user value objects, NOT the full {key, value} wrappers> }
-
-    Example: If a1.output.results = [{key: "user:001", value: {name: "Alice", age: 30}}, ...]
-    Then return: { "count": 2, "users": [{name: "Alice", age: 30}, ...] }
-
-    CRITICAL: Extract ONLY the .value objects so caller can access with .users[0].name directly
-    DO NOT use format action - return a real array!
-    """
-  }
-
-  on findAdults(args: Json) {
-    playbook """
-    Find all users aged 18 or older using registry search with query: { "age": { "$gte": 18 } }
-
-    EXACT STEPS:
-    1. Use registry_search with query: { "age": { "$gte": 18 } }
-    2. Return: { "count": [count from search], "adults": [results array] }
-
-    DO NOT add print actions - just return the data!
-    """
-  }
-
-  on updateUserAge(args: Json) {
-    playbook """
-    Update user ${args.id}'s age to ${args.age}.
-
-    EXACT STEPS:
-    1. Use registry_get with key "user:${args.id}", store with ID "a1"
-    2. Take the full user object from \${a1.output.value}
-    3. Modify ONLY the age field to ${args.age}, keep all other fields (name, email, createdAt, etc.)
-    4. Use registry_set with key "user:${args.id}" and the complete updated object
-    5. Return: { "success": true, "message": "Age updated" }
-
-    CRITICAL: Preserve ALL existing fields when saving!
-    """
-  }
-
-  on deleteUser(args: Json) {
-    playbook """
-    Borra el usuario del registro con ID ${args.id}.
-
-    EXACT STEPS:
-    1. Use registry_delete with key "user:\${args.id}"
-    2. Return: { "success": true, "message": "User deleted" }
-    """
-  }
-}
-
-// Team that groups our agents
-Team RegistryTeam {
-  userManager = UserManager
-}
-
-// Orchestrator - uses playbook, router finds UserManager automatically!
-Agent Demo : Manager {
-  llm default = { provider: "openai", model: "gpt-4o-mini" }
-  uses Team RegistryTeam
-
-  on start(args: Json) {
-    //SUPER IMPORTANT: DO NOT CHANGE THE FOLLOWING PROMPT AT ALL!!!!!!
-    playbook """
-    Ejecuta un demo del registro de usuarios.
-
-    Muestra el header:
-    ╔══════════════════════════════════════════════════╗
-    ║  Registry with Playbook Demo                     ║
-    ╚══════════════════════════════════════════════════╝
-
-    1️⃣ Crea estos usuarios:
-    - Alice: id=001, birthdate=1985-12-05, email=alice@example.com
-    - Bob: id=002, fecha de nacimiento: 12 de abril de 2001, bob@example.com
-    - Moema: id=003, birth date: 1992 enero 29, email=charlie@example.com
-    - Diana: id=004, birthdate: 12 del 12 del 12, diana@example.com
-    Muestra: "   ✅ X users created" X es la cantidad de usuarios que se crearon
-
-    2️⃣ Por cada usuario en la base de datos, escribe este correo:
-
-    Estimado (o Estimada si es chica, deducelo por el nombre) <nombre persona>,
-
-    Como sabemos que usted tiene {x} años, le queremos dar la enhorabuena!
-    
-    Atentamente,
-    La empresa!!
-
-    Muestra cada correo que escribieste.
-
-    Muestra el footer:
-    ╔══════════════════════════════════════════════════╗
-    ║  Demo completed successfully!                    ║
-    ╚══════════════════════════════════════════════════╝
-    """
-  }
-}
-
-run Demo.start({})