@agentspan/agentspan 0.0.3

package/cmd/agent.go

@@ -0,0 +1,120 @@
+// Copyright (c) 2025 AgentSpan
+// Licensed under the MIT License. See LICENSE file in the project root for details.
+
+package cmd
+
+import (
+	"encoding/json"
+	"fmt"
+	"os"
+
+	"github.com/agentspan/agentspan/cli/client"
+	"github.com/fatih/color"
+	"github.com/spf13/cobra"
+	"gopkg.in/yaml.v3"
+)
+
+var agentCmd = &cobra.Command{
+	Use:     "agent",
+	Aliases: []string{"a"},
+	Short:   "Manage agents",
+}
+
+func init() {
+	rootCmd.AddCommand(agentCmd)
+}
+
+// loadAgentConfig reads a YAML or JSON agent config file into a map
+func loadAgentConfig(path string) (map[string]interface{}, error) {
+	data, err := os.ReadFile(path)
+	if err != nil {
+		return nil, fmt.Errorf("read config file: %w", err)
+	}
+
+	var cfg map[string]interface{}
+
+	// Try YAML first (superset of JSON)
+	if err := yaml.Unmarshal(data, &cfg); err != nil {
+		// Fall back to JSON
+		if err := json.Unmarshal(data, &cfg); err != nil {
+			return nil, fmt.Errorf("parse config file (tried YAML and JSON): %w", err)
+		}
+	}
+
+	return cfg, nil
+}
+
+// printJSON pretty-prints a value as JSON
+func printJSON(v interface{}) {
+	data, _ := json.MarshalIndent(v, "", "  ")
+	fmt.Println(string(data))
+}
+
+// printSSEEvent formats and prints an SSE event
+func printSSEEvent(evt client.SSEEvent) {
+	var data map[string]interface{}
+	if err := json.Unmarshal([]byte(evt.Data), &data); err != nil {
+		// Not JSON, print raw
+		if evt.Event != "" {
+			fmt.Printf("[%s] %s\n", evt.Event, evt.Data)
+		}
+		return
+	}
+
+	eventType := evt.Event
+	if eventType == "" {
+		if t, ok := data["type"].(string); ok {
+			eventType = t
+		}
+	}
+
+	switch eventType {
+	case "thinking":
+		color.New(color.FgHiBlack).Printf("  [thinking] %s\n", truncate(dataStr(data, "message"), 120))
+	case "tool_call":
+		color.New(color.FgCyan).Printf("  [tool] %s(%s)\n", dataStr(data, "toolName"), truncate(dataStr(data, "input"), 100))
+	case "tool_result":
+		result := truncate(dataStr(data, "result"), 200)
+		color.New(color.FgCyan).Printf("  [result] %s -> %s\n", dataStr(data, "toolName"), result)
+	case "handoff":
+		color.New(color.FgYellow).Printf("  [handoff] -> %s\n", dataStr(data, "agentName"))
+	case "waiting":
+		color.New(color.FgYellow, color.Bold).Printf("  [waiting] Human input required (workflow: %s)\n", dataStr(data, "workflowId"))
+	case "guardrail_pass":
+		color.New(color.FgGreen).Printf("  [guardrail] PASS %s\n", dataStr(data, "guardrailName"))
+	case "guardrail_fail":
+		color.New(color.FgRed).Printf("  [guardrail] FAIL %s: %s\n", dataStr(data, "guardrailName"), dataStr(data, "reason"))
+	case "error":
+		color.New(color.FgRed, color.Bold).Printf("  [error] %s\n", dataStr(data, "message"))
+	case "done":
+		output := dataStr(data, "output")
+		if output != "" {
+			fmt.Println()
+			color.New(color.Bold).Println(output)
+		}
+	default:
+		if eventType != "" {
+			fmt.Printf("  [%s] %s\n", eventType, truncate(evt.Data, 150))
+		}
+	}
+}
+
+func dataStr(data map[string]interface{}, key string) string {
+	if v, ok := data[key]; ok {
+		switch val := v.(type) {
+		case string:
+			return val
+		default:
+			b, _ := json.Marshal(val)
+			return string(b)
+		}
+	}
+	return ""
+}
+
+func truncate(s string, max int) string {
+	if len(s) <= max {
+		return s
+	}
+	return s[:max] + "..."
+}

package/cmd/compile.go

@@ -0,0 +1,37 @@
+// Copyright (c) 2025 AgentSpan
+// Licensed under the MIT License. See LICENSE file in the project root for details.
+
+package cmd
+
+import (
+	"fmt"
+
+	"github.com/spf13/cobra"
+)
+
+var compileCmd = &cobra.Command{
+	Use:   "compile <config-file>",
+	Short: "Compile an agent config to a Conductor workflow definition",
+	Args:  cobra.ExactArgs(1),
+	RunE: func(cmd *cobra.Command, args []string) error {
+		agentConfig, err := loadAgentConfig(args[0])
+		if err != nil {
+			return err
+		}
+
+		cfg := getConfig()
+		c := newClient(cfg)
+
+		result, err := c.Compile(agentConfig)
+		if err != nil {
+			return fmt.Errorf("compilation failed: %w", err)
+		}
+
+		printJSON(result)
+		return nil
+	},
+}
+
+func init() {
+	agentCmd.AddCommand(compileCmd)
+}

package/cmd/configure.go

@@ -0,0 +1,48 @@
+// Copyright (c) 2025 AgentSpan
+// Licensed under the MIT License. See LICENSE file in the project root for details.
+
+package cmd
+
+import (
+	"fmt"
+
+	"github.com/agentspan/agentspan/cli/config"
+	"github.com/fatih/color"
+	"github.com/spf13/cobra"
+)
+
+var configureCmd = &cobra.Command{
+	Use:   "configure",
+	Short: "Configure the CLI (server URL, auth credentials)",
+	RunE: func(cmd *cobra.Command, args []string) error {
+		cfg := config.Load()
+
+		if url, _ := cmd.Flags().GetString("url"); url != "" {
+			cfg.ServerURL = url
+		}
+		if key, _ := cmd.Flags().GetString("auth-key"); key != "" {
+			cfg.AuthKey = key
+		}
+		if secret, _ := cmd.Flags().GetString("auth-secret"); secret != "" {
+			cfg.AuthSecret = secret
+		}
+
+		if err := config.Save(cfg); err != nil {
+			return fmt.Errorf("failed to save config: %w", err)
+		}
+
+		color.Green("Configuration saved!")
+		fmt.Printf("  Server URL: %s\n", cfg.ServerURL)
+		if cfg.AuthKey != "" {
+			fmt.Printf("  Auth Key:   %s\n", cfg.AuthKey)
+		}
+		return nil
+	},
+}
+
+func init() {
+	configureCmd.Flags().String("url", "", "Runtime server URL")
+	configureCmd.Flags().String("auth-key", "", "Auth key")
+	configureCmd.Flags().String("auth-secret", "", "Auth secret")
+	rootCmd.AddCommand(configureCmd)
+}

package/cmd/delete.go

@@ -0,0 +1,44 @@
+// Copyright (c) 2025 AgentSpan
+// Licensed under the MIT License. See LICENSE file in the project root for details.
+
+package cmd
+
+import (
+	"fmt"
+
+	"github.com/fatih/color"
+	"github.com/spf13/cobra"
+)
+
+var deleteVersion int
+
+var deleteCmd = &cobra.Command{
+	Use:   "delete <name>",
+	Short: "Delete an agent workflow definition",
+	Args:  cobra.ExactArgs(1),
+	RunE: func(cmd *cobra.Command, args []string) error {
+		cfg := getConfig()
+		c := newClient(cfg)
+
+		var versionPtr *int
+		if cmd.Flags().Changed("version") {
+			versionPtr = &deleteVersion
+		}
+
+		if err := c.DeleteAgent(args[0], versionPtr); err != nil {
+			return fmt.Errorf("failed to delete agent: %w", err)
+		}
+
+		if versionPtr != nil {
+			color.Green("Deleted agent '%s' version %d", args[0], *versionPtr)
+		} else {
+			color.Green("Deleted agent '%s' (latest version)", args[0])
+		}
+		return nil
+	},
+}
+
+func init() {
+	deleteCmd.Flags().IntVar(&deleteVersion, "version", 0, "Agent version to delete (default: latest)")
+	agentCmd.AddCommand(deleteCmd)
+}