@porchestra/cli 1.0.0

package/src/agents/testPrompt/ast.json

@@ -0,0 +1,71 @@
+{
+  "root": {
+    "id": "EvcRFNShH3",
+    "type": "block",
+    "children": [
+      {
+        "id": "QgKHml42sL",
+        "type": "text",
+        "content": "system prompt test"
+      },
+      {
+        "id": "KRvYYUqy7J",
+        "type": "block",
+        "children": [
+          {
+            "id": "YlHnTwSkEi",
+            "else": {
+              "id": "i2pRTTZQlM",
+              "type": "block",
+              "children": [
+                {
+                  "id": "Bd9VwLpfQO",
+                  "type": "text",
+                  "content": "val 1 not  provided"
+                }
+              ]
+            },
+            "then": {
+              "id": "Z30x3K8DQG",
+              "type": "block",
+              "children": [
+                {
+                  "id": "d1v8PEValw",
+                  "type": "text",
+                  "content": "val 1 provided"
+                }
+              ]
+            },
+            "type": "conditional",
+            "condition": {
+              "op": "eq",
+              "left": {
+                "path": "var",
+                "type": "variable"
+              },
+              "right": {
+                "type": "constant",
+                "value": "val1"
+              }
+            }
+          }
+        ]
+      }
+    ]
+  },
+  "version": "2.1.0",
+  "variables": [
+    {
+      "id": "mdMpwnrBKG",
+      "path": "var",
+      "type": "enum",
+      "validation": {
+        "options": [
+          "val1",
+          "val2"
+        ],
+        "required": true
+      }
+    }
+  ]
+}

package/src/agents/testPrompt/config.ts

@@ -0,0 +1,18 @@
+/**
+ * Auto-generated model config for testPrompt
+ * Generated: 2026-02-01T11:57:10.473Z
+ * Version: 1.0.0
+ * DO NOT MODIFY - This file is auto-generated by Porchestra CLI
+ */
+
+export const ModelConfig = {
+  "model": "gemini-3-flash-preview",
+  "provider": "GoogleGenAI",
+  "overrides": {},
+  "parameters": {
+    "thinking_config": {
+      "thinkingLevel": "LOW"
+    },
+    "response_mime_type": "application/json"
+  }
+} as const;

package/src/agents/testPrompt/index.ts

@@ -0,0 +1,64 @@
+/**
+ * Auto-generated Agent class for testPrompt
+ * Generated: 2026-02-01T11:57:10.473Z
+ * Version: 1.0.0
+ * DO NOT MODIFY - This file is auto-generated by Porchestra CLI
+ */
+
+import { PorchestraRuntime } from '@porchestra/core';
+import rawAst from './ast.json';
+import { ModelConfig } from './config.js';
+import * as Schemas from './schemas.js';
+import * as Tools from './tools.js';
+
+export class TestPromptAgent {
+  /**
+   * @param tools - The implementation of the tool logic. Required if the agent uses tools.
+   */
+  constructor(private readonly tools?: Tools.ToolImplementation) {}
+
+  /**
+   * Renders the System Prompt.
+   * Throws ZodError if variables are invalid.
+   */
+  public renderPrompt(variables: Schemas.AgentVariables): string {
+    const safeVars = Schemas.VariableSchema.parse(variables);
+    return PorchestraRuntime.render(rawAst as any, safeVars);
+  }
+
+  /**
+   * Routes an LLM Tool Call to your implementation.
+   * Validates arguments automatically.
+   */
+  public async handleTool(name: string, args: unknown): Promise<unknown> {
+    if (!this.tools) {
+      throw new Error('No tool implementation provided to Agent constructor.');
+    }
+    return Tools.dispatch(name, args, this.tools);
+  }
+
+  /** Validates User Input (e.g. from API Request) */
+  public static validateInput(data: unknown): Schemas.AgentInput {
+    return Schemas.InputSchema.parse(data);
+  }
+
+  /** Validates LLM Output (Post-generation check) */
+  public static validateResponse(data: unknown): Schemas.AgentResponse {
+    return Schemas.ResponseSchema.parse(data);
+  }
+
+  /** Get Provider Configuration */
+  public static get config() {
+    return ModelConfig;
+  }
+
+  /** Get Tool Definitions for the LLM Provider */
+  public static get toolDefinitions() {
+    return Tools.ToolDefinitions;
+  }
+
+  /** Get JSON Schema for Structured Outputs */
+  public static get responseFormat() {
+    return Schemas.ResponseJsonSchema;
+  }
+}

package/src/agents/testPrompt/schemas.ts

@@ -0,0 +1,45 @@
+/**
+ * Auto-generated Zod schemas for testPrompt
+ * Generated: 2026-02-01T11:57:10.473Z
+ * Version: 1.0.0
+ * DO NOT MODIFY - This file is auto-generated by Porchestra CLI
+ */
+
+import { z } from 'zod';
+
+// 1. System Prompt Variables
+export const VariableSchema = z.any();
+export type AgentVariables = z.infer<typeof VariableSchema>;
+
+// 2. User Input
+export const InputSchema = z.object({
+  "user-age": z.number().min(18)
+});
+export type AgentInput = z.infer<typeof InputSchema>;
+
+// 3. Model Response
+export const ResponseSchema = z.object({
+  "is-allowed": z.any()
+});
+export type AgentResponse = z.infer<typeof ResponseSchema>;
+
+// 4. Raw JSON Schema (for LLM Provider 'response_format')
+export const ResponseJsonSchema = {
+  "type": "object",
+  "required": [
+    "is-allowed"
+  ],
+  "properties": {
+    "is-allowed": {
+      "enum": [
+        "yes",
+        "no"
+      ],
+      "type": "enum",
+      "description": ""
+    }
+  },
+  "propertyOrdering": [
+    "is-allowed"
+  ]
+} as const;

package/src/agents/testPrompt/tools.ts

@@ -0,0 +1,88 @@
+/**
+ * Auto-generated tools for testPrompt
+ * Generated: 2026-02-01T11:57:10.473Z
+ * Version: 1.0.0
+ * DO NOT MODIFY - This file is auto-generated by Porchestra CLI
+ */
+
+import { z } from 'zod';
+
+// Schema for test-tool-1
+export const TestTool1Params = z.object({
+  "test-param-1": z.string(),
+  "test-param-2": z.number().int()
+});
+export type TestTool1ParamsType = z.infer<typeof TestTool1Params>;
+
+// Schema for test-tool-2
+export const TestTool2Params = z.object({
+  "test-param-1": z.string()
+});
+export type TestTool2ParamsType = z.infer<typeof TestTool2Params>;
+
+// The Interface the user MUST implement
+export interface ToolImplementation {
+  testTool1: (args: TestTool1ParamsType) => Promise<unknown>;
+  testTool2: (args: TestTool2ParamsType) => Promise<unknown>;
+}
+
+// Raw Tool Definitions for provider SDKs
+export const ToolDefinitions = [
+  {
+    name: 'test-tool-1',
+    description: "test tool",
+    parameters: {
+  "type": "object",
+  "required": [
+    "test-param-1",
+    "test-param-2"
+  ],
+  "properties": {
+    "test-param-1": {
+      "type": "string"
+    },
+    "test-param-2": {
+      "type": "integer"
+    }
+  },
+  "propertyOrdering": [
+    "test-param-1",
+    "test-param-2"
+  ]
+},
+  },
+  {
+    name: 'test-tool-2',
+    description: "test tool 2",
+    parameters: {
+  "type": "object",
+  "required": [
+    "test-param-1"
+  ],
+  "properties": {
+    "test-param-1": {
+      "type": "string"
+    }
+  },
+  "propertyOrdering": [
+    "test-param-1"
+  ]
+},
+  },
+] as const;
+
+// Dispatcher with validation
+export async function dispatch(
+  name: string,
+  args: unknown,
+  impl: ToolImplementation
+): Promise<unknown> {
+  switch (name) {
+    case 'test-tool-1':
+      return await impl.testTool1(TestTool1Params.parse(args));
+    case 'test-tool-2':
+      return await impl.testTool2(TestTool2Params.parse(args));
+    default:
+      throw new Error(`Unknown tool: ${name}`);
+  }
+}

package/src/commands/agents.ts

@@ -0,0 +1,173 @@
+import { Command } from 'commander';
+import { select, confirm } from '@inquirer/prompts';
+import pc from 'picocolors';
+import { ConfigManager } from '../core/config/config-manager.js';
+import { ProjectTracker } from '../core/config/project-tracker.js';
+import { formatDistanceToNow } from '../utils/date.js';
+
+interface ListOptions {
+  project?: string;
+  json?: boolean;
+}
+
+interface RemoveOptions {
+  project?: string;
+  force?: boolean;
+}
+
+export function createAgentsCommand(configManager: ConfigManager): Command {
+  const projectTracker = new ProjectTracker(configManager);
+
+  const listAction = async (options: ListOptions = {}) => {
+    let projects = await projectTracker.getTrackedProjects();
+
+    if (options.project) {
+      projects = projects.filter(
+        project => project.projectId === options.project || project.projectSlug === options.project
+      );
+
+      if (projects.length === 0) {
+        console.log(pc.red(`No tracked project found for "${options.project}"`));
+        return;
+      }
+    }
+
+    if (options.json) {
+      console.log(JSON.stringify(projects, null, 2));
+      return;
+    }
+
+    console.log(pc.bold('\n📁 Tracked Agents\n'));
+
+    if (projects.length === 0) {
+      console.log(pc.gray('  No agents tracked. Run `porchestra explore` to add agents.'));
+      console.log();
+      return;
+    }
+
+    let totalAgents = 0;
+
+    projects.forEach((project) => {
+      totalAgents += project.agents.length;
+      console.log(pc.bold(`  ${project.projectName}`));
+
+      project.agents.forEach((agent) => {
+        const lastPulled = agent.lastPulledAt
+          ? formatDistanceToNow(new Date(agent.lastPulledAt))
+          : 'pending';
+        const version = agent.lastPulledVersion ? ` @ ${agent.lastPulledVersion}` : '';
+
+        console.log(`    └─ ${pc.cyan(agent.agentName)}${version ? pc.gray(version) : ''}`);
+        console.log(pc.gray(`       ${agent.folderPath} (${lastPulled})`));
+      });
+
+      console.log();
+    });
+
+    console.log(pc.gray(`Total: ${projects.length} project(s), ${totalAgents} agent(s)\n`));
+  };
+
+  const command = new Command('agents')
+    .description('Manage tracked agents')
+    .action(async () => listAction());
+
+  command
+    .command('list')
+    .description('List tracked agents')
+    .option('-p, --project <id>', 'Filter by project id or slug')
+    .option('--json', 'Output raw JSON for scripting')
+    .action(listAction);
+
+  command
+    .command('remove [agent]')
+    .description('Stop tracking a specific agent')
+    .option('-p, --project <id>', 'Project id or slug (disambiguates agents with the same slug)')
+    .option('-f, --force', 'Skip confirmation prompt')
+    .action(async (agentArg: string | undefined, options: RemoveOptions) => {
+      let projects = await projectTracker.getTrackedProjects();
+
+      if (projects.length === 0) {
+        console.log(pc.gray('No agents tracked. Run `porchestra explore` first.'));
+        return;
+      }
+
+      if (options.project) {
+        projects = projects.filter(
+          project => project.projectId === options.project || project.projectSlug === options.project
+        );
+
+        if (projects.length === 0) {
+          console.log(pc.red(`No tracked project found for "${options.project}"`));
+          return;
+        }
+      }
+
+      const candidates = projects.flatMap((project) =>
+        project.agents.map((agent) => ({
+          project,
+          agent,
+          value: `${project.projectId}:${agent.agentId}`,
+        }))
+      );
+
+      let filtered = candidates;
+
+      if (agentArg) {
+        filtered = candidates.filter(({ agent }) =>
+          agent.agentId === agentArg || agent.agentSlug === agentArg
+        );
+      }
+
+      if (filtered.length === 0) {
+        const message = agentArg
+          ? `No tracked agent found for "${agentArg}".`
+          : 'No tracked agents found.';
+        console.log(pc.red(message));
+        return;
+      }
+
+      let target = filtered[0];
+
+      if (filtered.length > 1) {
+        const choice = await select({
+          message: 'Select an agent to stop tracking:',
+          choices: filtered.map(({ project, agent, value }) => ({
+            name: `${agent.agentName} ${pc.gray(`(${project.projectName}) ${agent.folderPath}`)}`,
+            value,
+          })),
+        });
+
+        target = filtered.find(candidate => candidate.value === choice)!;
+      }
+
+      if (!options.force) {
+        const confirmed = await confirm({
+          message: `Remove ${target.agent.agentName} from ${target.project.projectName}?`,
+          default: false,
+        });
+
+        if (!confirmed) return;
+      }
+
+      const removed = await projectTracker.untrackAgent(
+        target.project.projectId,
+        target.agent.agentId
+      );
+
+      if (!removed) {
+        console.log(pc.red('Agent was not removed (not found).'));
+        return;
+      }
+
+      const projectRemoved = target.project.agents.length === 1;
+
+      console.log(pc.green(`✓ Stopped tracking ${target.agent.agentName}`));
+      console.log(pc.gray(`  Project: ${target.project.projectName}`));
+
+      if (projectRemoved) {
+        console.log(pc.gray('  Project removed from tracking because it has no remaining agents.'));
+      }
+    });
+
+  return command;
+}

package/src/commands/config.ts

@@ -0,0 +1,97 @@
+import { Command } from 'commander';
+import { ConfigManager } from '../core/config/config-manager.js';
+import pc from 'picocolors';
+import { confirm } from '@inquirer/prompts';
+
+export function createConfigCommand(configManager: ConfigManager): Command {
+  const config = new Command('config')
+    .description('Manage CLI configuration');
+
+  config
+    .command('get <key>')
+    .description('Get a configuration value')
+    .action(async (key: string) => {
+      const cfg = await configManager.get();
+      const value = getNestedValue(cfg, key);
+      console.log(value !== undefined ? value : pc.gray('(not set)'));
+    });
+
+  config
+    .command('set <key> <value>')
+    .description('Set a configuration value')
+    .action(async (key: string, value: string) => {
+      await configManager.update((cfg) => {
+        return setNestedValue(cfg, key, parseValue(value));
+      });
+      console.log(pc.green(`✓ Set ${key} = ${value}`));
+    });
+
+  config
+    .command('list')
+    .description('List all configuration values')
+    .action(async () => {
+      const cfg = await configManager.get();
+      console.log(pc.bold('\nConfiguration:'));
+      printConfig(cfg);
+    });
+
+  config
+    .command('reset')
+    .description('Reset all configuration (WARNING: clears auth)')
+    .option('--force', 'Skip confirmation')
+    .action(async (options) => {
+      if (!options.force) {
+        const confirmed = await confirm({
+          message: 'This will clear all config including login. Continue?',
+          default: false
+        });
+        if (!confirmed) return;
+      }
+      await configManager.clear();
+      console.log(pc.green('✓ Configuration reset'));
+    });
+
+  return config;
+}
+
+function getNestedValue(obj: any, key: string): any {
+  return key.split('.').reduce((o, k) => o?.[k], obj);
+}
+
+function setNestedValue(obj: any, key: string, value: any): any {
+  const keys = key.split('.');
+  const last = keys.pop()!;
+  const target = keys.reduce((o, k) => {
+    if (!o[k]) o[k] = {};
+    return o[k];
+  }, obj);
+  target[last] = value;
+  return obj;
+}
+
+function parseValue(value: string): any {
+  if (value === 'true') return true;
+  if (value === 'false') return false;
+  if (value === 'null') return null;
+  if (!isNaN(Number(value))) return Number(value);
+  try {
+    return JSON.parse(value);
+  } catch {
+    return value;
+  }
+}
+
+function printConfig(obj: any, prefix = ''): void {
+  for (const [key, value] of Object.entries(obj)) {
+    const fullKey = prefix ? `${prefix}.${key}` : key;
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+      console.log(`\n${pc.cyan(fullKey)}:`);
+      printConfig(value, fullKey);
+    } else {
+      const displayValue = key.includes('token') 
+        ? pc.gray('***hidden***') 
+        : value;
+      console.log(`  ${fullKey} = ${displayValue}`);
+    }
+  }
+}