create-polos 0.1.0 → 0.1.2

package/dist/index.js

@@ -90,9 +90,6 @@ function tsconfigJsonTemplate() {
 // src/templates/env-example.ts
 function envExampleTemplate(provider) {
   return `${provider.envVar}=${provider.envPlaceholder}
-TAVILY_API_KEY=tvly-...
-# POLOS_API_URL=http://localhost:8080
-# POLOS_API_KEY=
 `;
 }
 
@@ -125,7 +122,7 @@ A Polos agent project using **${provider.label}**.
 
 3. Start the development server:
    \`\`\`bash
-   npx polos dev
+   polos dev
    \`\`\`
 
 ## Project Structure
@@ -135,7 +132,8 @@ src/
   main.ts                    # Entry point \u2014 imports agents, starts Polos
   agents/
     coding-agent.ts          # Coding agent with local sandbox tools
-    assistant-agent.ts       # Assistant with sandbox tools + web search + ask user
+    assistant-agent.ts       # Assistant with sandbox tools + ask user
+  workflows/
     text-review/
       agents.ts              # Grammar, tone, correctness, and editor agents
       workflow.ts            # Parallel review workflow
@@ -144,12 +142,40 @@ src/
 ## Agents
 
 - **coding_agent** \u2014 A coding agent with local sandbox tools (exec, read, write, edit, glob, grep)
-- **assistant_agent** \u2014 An assistant with sandbox tools, web search, and ask user
-- **text_review** \u2014 A workflow that runs 3 reviewers in parallel, then a final editor
+- **assistant_agent** \u2014 An assistant with sandbox tools and ask user
+
+## Workflows
+
+- **text_review** \u2014 A workflow that runs 3 reviewer agents in parallel, then a final editor agent
+  - **grammar_review** \u2014 A grammar review agent
+  - **tone_review** \u2014 A tone review agent
+  - **correctness_review** \u2014 A correctness review agent
+  - **editor_review** \u2014 An editor review agent
+
+## Running an Agent
+
+With \`polos dev\` running, open another terminal:
+
+\`\`\`bash
+# Interactive REPL
+polos run assistant_agent
+
+# One-shot
+polos run assistant_agent --input "Summarize the latest news about AI"
+\`\`\`
+
+## Running a Workflow
+
+\`\`\`bash
+polos invoke text_review --input "The quick brown fox jumps over the lazy dog."
+
+# Check result
+polos result <execution-id>
+\`\`\`
 
 ## Learn More
 
-- [Polos Documentation](https://docs.polos.dev)
+- [Polos Documentation](https://polos.dev/docs)
 `;
 }
 
@@ -161,10 +187,24 @@ import { Polos } from '@polos/sdk';
 // Import agents and workflows for registration
 import './agents/coding-agent.js';
 import './agents/assistant-agent.js';
-import './agents/text-review/agents.js';
-import './agents/text-review/workflow.js';
+import './workflows/text-review/agents.js';
+import './workflows/text-review/workflow.js';
 
 const polos = new Polos();
+
+console.log('');
+console.log('\\x1b[1mPolos worker starting...\\x1b[0m');
+console.log('');
+console.log(\`  UI:        \${process.env.POLOS_UI_URL || 'http://localhost:5173'}\`);
+console.log('');
+console.log('  Run an agent:');
+console.log('    polos run assistant_agent');
+console.log('    polos run coding_agent --input "Write a hello world script"');
+console.log('');
+console.log('  Run a workflow:');
+console.log('    polos invoke text_review --input "Your text here"');
+console.log('');
+
 await polos.serve();
 `;
 }
@@ -173,24 +213,16 @@ await polos.serve();
 function codingAgentTemplate(provider) {
   return `${provider.import};
 import { defineAgent, maxSteps, sandboxTools } from '@polos/sdk';
-import path from 'node:path';
-
-const workspaceDir = path.resolve(process.cwd(), 'workspace');
 
 const tools = sandboxTools({
   env: 'local',
-  local: {
-    cwd: workspaceDir,
-    pathRestriction: workspaceDir,
-  },
+  scope: 'session',
 });
 
 export const codingAgent = defineAgent({
   id: 'coding_agent',
   model: ${provider.call},
-  systemPrompt: \`You are a coding agent with access to sandbox tools.
-Your workspace is at \${workspaceDir}.
-Use your tools to read, write, and execute code.\`,
+  systemPrompt: 'You are a coding agent with access to sandbox tools. Use your tools to read, write, and execute code.',
   tools,
   stopConditions: [maxSteps({ count: 30 })],
 });
@@ -204,37 +236,18 @@ import {
   defineAgent,
   maxSteps,
   sandboxTools,
-  createWebSearchTool,
-  createAskUserTool,
 } from '@polos/sdk';
-import path from 'node:path';
-
-const workspaceDir = path.resolve(process.cwd(), 'workspace');
 
 const sandbox = sandboxTools({
   env: 'local',
-  local: {
-    cwd: workspaceDir,
-    pathRestriction: workspaceDir,
-  },
-});
-
-const webSearch = createWebSearchTool({
-  maxResults: 5,
-  searchDepth: 'basic',
-  includeAnswer: true,
-  approval: 'always',
+  scope: 'session',
 });
 
-const askUser = createAskUserTool();
-
 export const assistantAgent = defineAgent({
   id: 'assistant_agent',
   model: ${provider.call},
-  systemPrompt: \`You are a helpful assistant with access to sandbox tools, web search, and the ability to ask the user for clarification.
-Your workspace is at \${workspaceDir}.
-Use your tools to help the user with their tasks.\`,
-  tools: [...sandbox, webSearch, askUser],
+  systemPrompt: 'You are a helpful assistant with access to sandbox tools. Use your tools to help the user with their tasks.',
+  tools: [...sandbox],
   stopConditions: [maxSteps({ count: 30 })],
 });
 `;
@@ -367,8 +380,8 @@ function generateFiles(projectName, provider) {
     { path: "src/main.ts", content: mainTsTemplate() },
     { path: "src/agents/coding-agent.ts", content: codingAgentTemplate(provider) },
     { path: "src/agents/assistant-agent.ts", content: assistantAgentTemplate(provider) },
-    { path: "src/agents/text-review/agents.ts", content: textReviewAgentsTemplate(provider) },
-    { path: "src/agents/text-review/workflow.ts", content: textReviewWorkflowTemplate() }
+    { path: "src/workflows/text-review/agents.ts", content: textReviewAgentsTemplate(provider) },
+    { path: "src/workflows/text-review/workflow.ts", content: textReviewWorkflowTemplate() }
   ];
 }
 function scaffoldProject(projectDir, files) {
@@ -427,7 +440,7 @@ async function main() {
   s.start("Creating project files...");
   const files = generateFiles(projectName, provider);
   scaffoldProject(projectDir, files);
-  s.stop("Project files created.");
+  s.stop("Installing project...");
   s.start("Installing dependencies...");
   const installed = installDependencies(projectDir);
   if (installed) {
@@ -440,6 +453,11 @@ async function main() {
   Next steps:
     cd ${projectName}
     cp .env.example .env     # add your ${provider.envVar}
-    npx polos dev`);
+    polos dev
+
+  Common commands:
+    polos agent list                         # list registered agents
+    polos run assistant_agent                # chat with the assistant agent
+    polos run assistant_agent --input "hi"   # one-shot mode`);
 }
 main().catch(console.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-polos",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Scaffold a new Polos agent project",
   "type": "module",
   "bin": {
@@ -19,6 +19,11 @@
     "scaffolding",
     "cli"
   ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/polos-dev/polos",
+    "directory": "create-polos-ts"
+  },
   "license": "Apache-2.0",
   "dependencies": {
     "@clack/prompts": "^0.9.1"