@output.ai/cli 0.0.1 → 0.0.3

package/dist/templates/agent_instructions/meta/pre_flight.md.template

@@ -0,0 +1,60 @@
+---
+description: Pre-Flight Checks for Output SDK Workflow Operations
+version: 1.0
+encoding: UTF-8
+---
+
+# Pre-Flight Rules for Output SDK Workflows
+
+## Execution Requirements
+
+- **CRITICAL**: For any step that specifies a subagent in the `subagent=""` XML attribute, you MUST use the specified subagent to perform the instructions for that step
+- Process all XML blocks sequentially and completely
+- Execute every numbered step in the process_flow EXACTLY as specified
+
+## Output SDK Conventions Check
+
+Before proceeding with any workflow operation, verify:
+
+- **ES Modules**: All imports MUST use `.js` extension for ESM modules
+- **HTTP Client**: NEVER use axios directly - always use @output.ai/http wrapper
+- **LLM Client**: NEVER use a direct llm call - always use @output.ai/llm wrapper
+- **Worker Restarts**: Remember to restart worker after creating workflows: `overmind restart worker`
+- **Documentation**: Run `yarn g:workflow-doc` after modifications
+
+## Requirements Gathering Strategy
+
+### Smart Defaults Application
+When information is not explicitly provided, apply these defaults:
+- **Retry Policies**: 3 attempts with exponential backoff (1s initial, 10s max)
+- **OpenAI Models**: Use `gpt-4o` unless specified otherwise
+- **Error Handling**: ApplicationFailure patterns with appropriate error types
+- **Performance**: Optimize for clarity and maintainability over raw speed
+- **Timeouts**: 30 seconds for activities, 5 minutes for workflows
+
+### Critical Information Requirements
+Only stop to ask for clarification on:
+- Ambiguous input/output structures that cannot be inferred from context
+- Specific API keys or services not commonly used in the project
+- Non-standard error handling or recovery requirements
+- Complex orchestration patterns requiring specific sequencing
+- External dependencies not already in the project
+
+## Template Processing Rules
+
+- Use exact templates as provided in each step
+- Replace all template variables with actual values:
+  - `{{workflowName}}` - The workflow being planned
+  - `{{projectPath}}` - Root project directory path
+  - `{{requirements}}` - User-provided requirements
+  - `{{currentDate}}` - Current date in YYYY-MM-DD format
+  - `{{sdkVersion}}` - Current Output SDK version
+
+## Quality Gates
+
+Before proceeding past pre-flight:
+1. Confirm all required context is available
+2. Verify understanding of the workflow's purpose
+3. Check for existing similar workflows to use as patterns
+4. Ensure Output SDK conventions are understood
+5. Validate that necessary subagents are available

package/dist/templates/workflow/README.md.template

@@ -4,7 +4,7 @@
 
 ## Overview
 
-This workflow was generated using the Flow SDK CLI. It provides a starting point for building Temporal-based workflows with LLM integration.
+This workflow was generated using the Output SDK CLI. It provides a starting point for building Temporal-based workflows with LLM integration.
 
 ## Files
 
@@ -63,7 +63,7 @@ Example:
 
 ### Workflow Structure
 
-The workflow follows the new Flow SDK conventions:
+The workflow follows the new Output SDK conventions:
 
 ```typescript
 import { workflow } from '@output.ai/core';
@@ -192,8 +192,8 @@ Please provide a helpful response.
 To test your workflow:
 
 1. Build the parent project containing this workflow
-2. Start the Flow worker
-3. Execute the workflow using the Flow SDK API
+2. Start the Output worker
+3. Execute the workflow using the Output SDK API
 
 Example execution:
 ```bash
@@ -210,6 +210,6 @@ curl -X POST http://localhost:3001/workflow \
 
 ## Resources
 
-- [Flow SDK Documentation](https://github.com/growthxai/flow-sdk)
+- [Output SDK Documentation](https://github.com/growthxai/output-sdk)
 - [Temporal Documentation](https://docs.temporal.io)
 - [AI SDK Documentation](https://sdk.vercel.ai/docs)

package/dist/utils/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const OUTPUT_FORMAT: {
+    readonly JSON: "json";
+    readonly TEXT: "text";
+};
+export type OutputFormat = typeof OUTPUT_FORMAT[keyof typeof OUTPUT_FORMAT];

package/dist/utils/constants.js

@@ -0,0 +1,4 @@
+export const OUTPUT_FORMAT = {
+    JSON: 'json',
+    TEXT: 'text'
+};

package/dist/utils/error_handler.d.ts

@@ -0,0 +1,8 @@
+type ErrorOverrides = {
+    [statusCode: number]: string;
+    ECONNREFUSED?: string;
+};
+export declare function handleApiError(error: unknown, errorFn: (...args: [message: string, options: {
+    exit: number;
+}]) => never, overrides?: ErrorOverrides): never;
+export {};

package/dist/utils/error_handler.js

@@ -0,0 +1,25 @@
+import { config } from '../config.js';
+const DEFAULT_MESSAGES = {
+    ECONNREFUSED: `Connection refused to ${config.apiUrl}. Is the API server running?`,
+    401: 'Authentication failed. Check your API_AUTH_TOKEN.',
+    404: 'Resource not found.',
+    UNKNOWN: 'An unknown error occurred.'
+};
+export function handleApiError(error, errorFn, overrides = {}) {
+    const apiError = error;
+    const errorMessages = { ...DEFAULT_MESSAGES, ...overrides };
+    if (apiError.code === 'ECONNREFUSED') {
+        return errorFn(errorMessages.ECONNREFUSED, { exit: 1 });
+    }
+    if (apiError.response?.status) {
+        const status = apiError.response.status;
+        const message = errorMessages[status];
+        if (message) {
+            return errorFn(message, { exit: 1 });
+        }
+    }
+    if (apiError.message) {
+        return errorFn(apiError.message, { exit: 1 });
+    }
+    return errorFn(errorMessages.UNKNOWN, { exit: 1 });
+}

package/dist/utils/input_parser.d.ts

@@ -0,0 +1 @@
+export declare function parseInputFlag(input: string): unknown;

package/dist/utils/input_parser.js

@@ -0,0 +1,19 @@
+import { readFileSync } from 'node:fs';
+export function parseInputFlag(input) {
+    try {
+        return JSON.parse(input);
+    }
+    catch {
+        try {
+            const fileContent = readFileSync(input, 'utf-8');
+            return JSON.parse(fileContent);
+        }
+        catch (error) {
+            const err = error;
+            if (err.code === 'ENOENT') {
+                throw new Error(`Input file not found: ${input}`);
+            }
+            throw new Error(`Invalid JSON input: ${err.message}`);
+        }
+    }
+}

package/dist/utils/output_formatter.d.ts

@@ -0,0 +1,2 @@
+import { OutputFormat } from './constants.js';
+export declare function formatOutput<T>(result: T, format: OutputFormat, textFormatter?: (result: T) => string): string;

package/dist/utils/output_formatter.js

@@ -0,0 +1,11 @@
+import { OUTPUT_FORMAT } from './constants.js';
+export function formatOutput(result, format, textFormatter = result => JSON.stringify(result, null, 2)) {
+    switch (format) {
+        case OUTPUT_FORMAT.JSON:
+            return JSON.stringify(result, null, 2);
+        case OUTPUT_FORMAT.TEXT:
+            return textFormatter(result);
+        default:
+            return textFormatter(result);
+    }
+}

package/dist/utils/paths.d.ts

@@ -3,6 +3,7 @@
  */
 export declare const TEMPLATE_DIRS: {
     readonly workflow: string;
+    readonly agent_instructions: string;
 };
 /**
  * Default output directories
@@ -22,3 +23,7 @@ export declare function createTargetDir(outputDir: string, workflowName: string)
  * Get the template directory for a specific template type
  */
 export declare function getTemplateDir(templateType: keyof typeof TEMPLATE_DIRS): string;
+/**
+ * Get the agent instruction directory for a specific category
+ */
+export declare function getAgentInstructionDir(category: 'agents' | 'commands'): string;

package/dist/utils/paths.js

@@ -6,7 +6,8 @@ const __dirname = path.dirname(__filename);
  * Template directory paths
  */
 export const TEMPLATE_DIRS = {
-    workflow: path.join(__dirname, '..', 'templates', 'workflow')
+    workflow: path.join(__dirname, '..', 'templates', 'workflow'),
+    agent_instructions: path.join(__dirname, '..', 'templates', 'agent_instructions')
 };
 /**
  * Default output directories
@@ -33,3 +34,9 @@ export function createTargetDir(outputDir, workflowName) {
 export function getTemplateDir(templateType) {
     return TEMPLATE_DIRS[templateType];
 }
+/**
+ * Get the agent instruction directory for a specific category
+ */
+export function getAgentInstructionDir(category) {
+    return path.join(TEMPLATE_DIRS.agent_instructions, category);
+}

package/package.json

@@ -1,12 +1,24 @@
 {
   "name": "@output.ai/cli",
+  "version": "0.0.3",
   "description": "CLI for Output.ai workflow generation",
-  "version": "0.0.1",
-  "author": "Ben Church",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "./bin",
+    "./dist",
+    "./oclif.manifest.json"
+  ],
   "bin": {
-    "output-cli": "./bin/run.js"
+    "output": "./bin/run.js"
+  },
+  "scripts": {
+    "build": "rm -rf ./dist && tsc && copyfiles -u 1 './src/templates/**/*.template' './src/templates/**/.env.template' './src/templates/**/*.prompt.template' dist",
+    "test": "vitest run",
+    "generate:api": "orval --config ./orval.config.ts",
+    "prebuild": "npm run generate:api"
   },
-  "bugs": "https://github.com/growthxai/flow-sdk/issues",
   "dependencies": {
     "@oclif/core": "^4",
     "@oclif/plugin-help": "^6",
@@ -26,24 +38,10 @@
     "orval": "^7.13.0",
     "slash": "^5.1.0"
   },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "files": [
-    "./bin",
-    "./dist",
-    "./oclif.manifest.json"
-  ],
-  "homepage": "https://github.com/growthxai/flow-sdk",
-  "keywords": [
-    "oclif"
-  ],
-  "license": "MIT",
-  "main": "dist/index.js",
-  "type": "module",
+  "license": "UNLICENSED",
   "oclif": {
-    "bin": "output-cli",
-    "dirname": "output-cli",
+    "bin": "output",
+    "dirname": "output",
     "commands": "./dist/commands",
     "plugins": [
       "@oclif/plugin-help",
@@ -53,15 +51,15 @@
     "topics": {
       "workflow": {
         "description": "Manage Output.ai workflows"
+      },
+      "config": {
+        "description": "Configure Output.ai CLI",
+        "subtopics": {
+          "agents": {
+            "description": "Manage AI agent configurations"
+          }
+        }
       }
     }
-  },
-  "repository": "sdk/cli",
-  "scripts": {
-    "build": "rm -rf ./dist && tsc && copyfiles -u 1 './src/templates/**/*.template' './src/templates/**/.env.template' './src/templates/**/*.prompt.template' dist",
-    "test": "vitest run",
-    "generate:api": "orval --config ./orval.config.ts",
-    "prebuild": "npm run generate:api"
-  },
-  "types": "dist/index.d.ts"
+  }
 }