create-struere 0.1.0

package/dist/index.js

@@ -0,0 +1,420 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { program } from "commander";
+import prompts from "prompts";
+
+// src/create-project.ts
+import { mkdir, writeFile } from "fs/promises";
+import { join } from "path";
+import chalk from "chalk";
+import ora from "ora";
+
+// src/templates/index.ts
+function getTemplates(projectName) {
+  return {
+    "package.json": getPackageJson(projectName),
+    "tsconfig.json": getTsConfig(),
+    "struere.config.ts": getStruereConfig(),
+    "src/agent.ts": getAgentTs(projectName),
+    "src/context.ts": getContextTs(),
+    "src/tools.ts": getToolsTs(),
+    "src/workflows/.gitkeep": "",
+    "api/chat.ts": getVercelApiHandler(),
+    "tests/basic.test.yaml": getBasicTestYaml(),
+    ".env.example": getEnvExample(),
+    "README.md": getReadme(projectName),
+    ".gitignore": getGitignore()
+  };
+}
+function getPackageJson(name) {
+  return JSON.stringify({
+    name,
+    version: "0.1.0",
+    type: "module",
+    scripts: {
+      dev: "struere dev",
+      build: "struere build",
+      test: "struere test",
+      deploy: "struere deploy"
+    },
+    dependencies: {
+      "@struere/core": "^0.1.0",
+      "@struere/runtime": "^0.1.0"
+    },
+    devDependencies: {
+      "@struere/cli": "^0.1.0",
+      "bun-types": "^1.0.0",
+      typescript: "^5.3.0"
+    }
+  }, null, 2);
+}
+function getTsConfig() {
+  return JSON.stringify({
+    compilerOptions: {
+      target: "ES2022",
+      module: "ESNext",
+      moduleResolution: "bundler",
+      lib: ["ES2022"],
+      strict: true,
+      esModuleInterop: true,
+      skipLibCheck: true,
+      forceConsistentCasingInFileNames: true,
+      outDir: "dist",
+      rootDir: "src",
+      types: ["bun-types"]
+    },
+    include: ["src/**/*"],
+    exclude: ["node_modules", "dist"]
+  }, null, 2);
+}
+function getStruereConfig() {
+  return `import { defineConfig } from '@struere/core'
+
+export default defineConfig({
+  port: 3000,
+  host: 'localhost',
+  cors: {
+    origins: ['http://localhost:3000'],
+    credentials: true,
+  },
+  logging: {
+    level: 'info',
+    format: 'pretty',
+  },
+})
+`;
+}
+function getAgentTs(name) {
+  const displayName = name.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+  return `import { defineAgent } from '@struere/core'
+import { context } from './context'
+import { tools } from './tools'
+
+export default defineAgent({
+  name: '${name}',
+  version: '0.1.0',
+  description: '${displayName} Agent',
+  model: {
+    provider: 'anthropic',
+    name: 'claude-sonnet-4-20250514',
+    temperature: 0.7,
+    maxTokens: 4096,
+  },
+  systemPrompt: \`You are ${displayName}, a helpful AI assistant.
+
+Your capabilities:
+- Answer questions accurately and helpfully
+- Use available tools when appropriate
+- Maintain conversation context
+
+Always be concise, accurate, and helpful.\`,
+  tools,
+  context,
+  state: {
+    storage: 'memory',
+    ttl: 3600,
+  },
+})
+`;
+}
+function getContextTs() {
+  return `import { defineContext } from '@struere/core'
+
+export const context = defineContext(async (request) => {
+  const { conversationId, userId, channel, state } = request
+
+  return {
+    additionalContext: \`
+Current conversation: \${conversationId}
+Channel: \${channel}
+\`,
+    variables: {
+      userId,
+      timestamp: new Date().toISOString(),
+    },
+  }
+})
+`;
+}
+function getToolsTs() {
+  return `import { defineTools } from '@struere/core'
+
+export const tools = defineTools([
+  {
+    name: 'get_current_time',
+    description: 'Get the current date and time',
+    parameters: {
+      type: 'object',
+      properties: {
+        timezone: {
+          type: 'string',
+          description: 'Timezone (e.g., "America/New_York", "UTC")',
+        },
+      },
+    },
+    handler: async (params) => {
+      const timezone = (params.timezone as string) || 'UTC'
+      const now = new Date()
+      return {
+        timestamp: now.toISOString(),
+        formatted: now.toLocaleString('en-US', { timeZone: timezone }),
+        timezone,
+      }
+    },
+  },
+  {
+    name: 'calculate',
+    description: 'Perform a mathematical calculation',
+    parameters: {
+      type: 'object',
+      properties: {
+        expression: {
+          type: 'string',
+          description: 'Mathematical expression to evaluate (e.g., "2 + 2")',
+        },
+      },
+      required: ['expression'],
+    },
+    handler: async (params) => {
+      const expression = params.expression as string
+      const sanitized = expression.replace(/[^0-9+-*/().\\s]/g, '')
+      try {
+        const result = new Function(\`return \${sanitized}\`)()
+        return { expression, result }
+      } catch {
+        return { expression, error: 'Invalid expression' }
+      }
+    },
+  },
+])
+`;
+}
+function getBasicTestYaml() {
+  return `name: Basic conversation test
+description: Verify the agent responds correctly to basic queries
+
+conversation:
+  - role: user
+    content: Hello, what can you do?
+  - role: assistant
+    assertions:
+      - type: contains
+        value: help
+
+  - role: user
+    content: What time is it?
+  - role: assistant
+    assertions:
+      - type: toolCalled
+        value: get_current_time
+`;
+}
+function getEnvExample() {
+  return `# Anthropic API Key (default provider)
+ANTHROPIC_API_KEY=your_api_key_here
+
+# Optional: OpenAI API Key (if using OpenAI models)
+# OPENAI_API_KEY=your_openai_api_key
+
+# Optional: Google AI API Key (if using Gemini models)
+# GOOGLE_GENERATIVE_AI_API_KEY=your_google_api_key
+
+# Optional: Custom API endpoint
+# STRUERE_API_URL=https://api.struere.dev
+`;
+}
+function getReadme(name) {
+  const displayName = name.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+  return `# ${displayName}
+
+An AI agent built with Struere.
+
+## Getting Started
+
+1. Install dependencies:
+   \`\`\`bash
+   bun install
+   \`\`\`
+
+2. Set up your environment:
+   \`\`\`bash
+   cp .env.example .env
+   # Edit .env and add your API keys
+   \`\`\`
+
+3. Start the development server:
+   \`\`\`bash
+   bun run dev
+   \`\`\`
+
+4. Open http://localhost:3000 to chat with your agent.
+
+## Project Structure
+
+- \`src/agent.ts\` - Main agent definition (system prompt, model config)
+- \`src/context.ts\` - Dynamic context injection
+- \`src/tools.ts\` - Custom tools for the agent
+- \`src/workflows/\` - Multi-step workflows (coming soon)
+- \`api/chat.ts\` - Vercel Edge API handler for production
+- \`tests/\` - Test conversations
+- \`struere.config.ts\` - Framework configuration
+
+## Commands
+
+- \`bun run dev\` - Start development server with hot reload
+- \`bun run build\` - Build and validate the agent
+- \`bun run test\` - Run test conversations
+- \`bun run deploy\` - Deploy to Struere cloud
+
+## Deploy to Vercel
+
+This project is ready for Vercel deployment:
+
+1. Push to GitHub
+2. Import in Vercel
+3. Add your \`ANTHROPIC_API_KEY\` to environment variables
+4. Deploy!
+
+The \`api/chat.ts\` file provides a streaming chat endpoint at \`/api/chat\`.
+
+## API Usage
+
+Send a POST request to \`/api/chat\`:
+
+\`\`\`bash
+curl -X POST https://your-app.vercel.app/api/chat \\
+  -H "Content-Type: application/json" \\
+  -d '{"message": "Hello!", "stream": true}'
+\`\`\`
+
+## Documentation
+
+Visit [struere.dev/docs](https://struere.dev/docs) for full documentation.
+`;
+}
+function getGitignore() {
+  return `# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Vercel
+.vercel/
+`;
+}
+function getVercelApiHandler() {
+  return `import agent from '../src/agent'
+import { createVercelHandler } from '@struere/runtime/serverless/vercel'
+
+export default createVercelHandler(agent, {
+  streaming: true,
+  corsOrigins: ['*'],
+})
+
+export const config = {
+  runtime: 'edge',
+}
+`;
+}
+
+// src/create-project.ts
+async function createProject(name, options) {
+  const projectPath = join(process.cwd(), name);
+  const spinner = ora();
+  console.log();
+  console.log(chalk.bold(`Creating ${chalk.cyan(name)}...`));
+  console.log();
+  spinner.start("Creating project structure");
+  try {
+    await mkdir(projectPath, { recursive: true });
+    await mkdir(join(projectPath, "src"), { recursive: true });
+    await mkdir(join(projectPath, "src", "workflows"), { recursive: true });
+    await mkdir(join(projectPath, "api"), { recursive: true });
+    await mkdir(join(projectPath, "tests"), { recursive: true });
+    spinner.succeed("Project structure created");
+    spinner.start("Writing template files");
+    const templates = getTemplates(name);
+    for (const [filePath, content] of Object.entries(templates)) {
+      const fullPath = join(projectPath, filePath);
+      await writeFile(fullPath, content, "utf-8");
+    }
+    spinner.succeed("Template files written");
+    if (options.install) {
+      spinner.start("Installing dependencies");
+      const proc = Bun.spawn(["bun", "install"], {
+        cwd: projectPath,
+        stdout: "pipe",
+        stderr: "pipe"
+      });
+      await proc.exited;
+      if (proc.exitCode === 0) {
+        spinner.succeed("Dependencies installed");
+      } else {
+        spinner.warn("Failed to install dependencies. Run `bun install` manually.");
+      }
+    }
+    console.log();
+    console.log(chalk.green("Success!"), `Created ${chalk.cyan(name)} at ${chalk.gray(projectPath)}`);
+    console.log();
+    console.log("Next steps:");
+    console.log();
+    console.log(chalk.gray("  $"), chalk.cyan(`cd ${name}`));
+    if (!options.install) {
+      console.log(chalk.gray("  $"), chalk.cyan("bun install"));
+    }
+    console.log(chalk.gray("  $"), chalk.cyan("bun run dev"));
+    console.log();
+    console.log("Documentation:", chalk.blue("https://struere.dev/docs"));
+    console.log();
+  } catch (error) {
+    spinner.fail("Failed to create project");
+    console.error(error);
+    process.exit(1);
+  }
+}
+
+// src/index.ts
+async function askProjectName() {
+  const response = await prompts({
+    type: "text",
+    name: "name",
+    message: "What is your agent name?",
+    validate: (value) => {
+      if (!value)
+        return "Agent name is required";
+      if (!/^[a-z0-9-]+$/.test(value)) {
+        return "Agent name must be lowercase alphanumeric with hyphens";
+      }
+      return true;
+    }
+  });
+  if (!response.name) {
+    process.exit(1);
+  }
+  return response.name;
+}
+program.name("create-struere").description("Create a new Struere project").argument("[name]", "Project name").option("-t, --template <template>", "Template to use", "default").option("--no-install", "Skip dependency installation").action(async (name, options) => {
+  const projectName = name || await askProjectName();
+  await createProject(projectName, options);
+}).parse();

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "create-struere",
+  "version": "0.1.0",
+  "description": "Create new Struere projects with a single command",
+  "keywords": ["ai", "agents", "scaffolding", "create", "generator", "llm"],
+  "author": "struere",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/struere/struere.git",
+    "directory": "packages/create-struere"
+  },
+  "homepage": "https://struere.dev",
+  "bugs": {
+    "url": "https://github.com/struere/struere/issues"
+  },
+  "type": "module",
+  "bin": {
+    "create-struere": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": ["dist"],
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target node --external commander --external prompts --external chalk --external ora && chmod +x ./dist/index.js",
+    "dev": "bun run ./src/index.ts",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "ora": "^8.0.0",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/prompts": "^2.4.9",
+    "bun-types": "^1.0.0",
+    "typescript": "^5.3.0"
+  }
+}