@agentspan/agentspan 0.0.3

package/config/config.go

@@ -0,0 +1,78 @@
+// Copyright (c) 2025 AgentSpan
+// Licensed under the MIT License. See LICENSE file in the project root for details.
+
+package config
+
+import (
+	"encoding/json"
+	"os"
+	"path/filepath"
+)
+
+type Config struct {
+	ServerURL  string `json:"server_url"`
+	AuthKey    string `json:"auth_key,omitempty"`
+	AuthSecret string `json:"auth_secret,omitempty"`
+}
+
+func DefaultConfig() *Config {
+	return &Config{
+		ServerURL: "http://localhost:8080",
+	}
+}
+
+func ConfigDir() string {
+	home, _ := os.UserHomeDir()
+	return filepath.Join(home, ".agentspan")
+}
+
+func configPath() string {
+	return filepath.Join(ConfigDir(), "config.json")
+}
+
+func Load() *Config {
+	cfg := DefaultConfig()
+
+	// Env vars override
+	if url := os.Getenv("AGENT_SERVER_URL"); url != "" {
+		cfg.ServerURL = url
+	}
+	if key := os.Getenv("CONDUCTOR_AUTH_KEY"); key != "" {
+		cfg.AuthKey = key
+	}
+	if secret := os.Getenv("CONDUCTOR_AUTH_SECRET"); secret != "" {
+		cfg.AuthSecret = secret
+	}
+
+	// File overrides (env vars take precedence)
+	data, err := os.ReadFile(configPath())
+	if err != nil {
+		return cfg
+	}
+	var fileCfg Config
+	if json.Unmarshal(data, &fileCfg) == nil {
+		if cfg.ServerURL == "http://localhost:8080" && fileCfg.ServerURL != "" {
+			cfg.ServerURL = fileCfg.ServerURL
+		}
+		if cfg.AuthKey == "" && fileCfg.AuthKey != "" {
+			cfg.AuthKey = fileCfg.AuthKey
+		}
+		if cfg.AuthSecret == "" && fileCfg.AuthSecret != "" {
+			cfg.AuthSecret = fileCfg.AuthSecret
+		}
+	}
+
+	return cfg
+}
+
+func Save(cfg *Config) error {
+	dir := ConfigDir()
+	if err := os.MkdirAll(dir, 0o700); err != nil {
+		return err
+	}
+	data, err := json.MarshalIndent(cfg, "", "  ")
+	if err != nil {
+		return err
+	}
+	return os.WriteFile(configPath(), data, 0o600)
+}

package/examples/multi-agent.yaml

@@ -0,0 +1,22 @@
+name: research-team
+description: A multi-agent research team
+model: openai/gpt-4o
+instructions: Route user requests to the appropriate specialist agent.
+strategy: handoff
+agents:
+  - name: researcher
+    description: Finds and summarizes information
+    model: openai/gpt-4o
+    instructions: |
+      You are a research specialist. Find relevant information and provide
+      well-sourced summaries.
+    tools:
+      - name: web_search
+        type: worker
+  - name: writer
+    description: Writes polished content
+    model: openai/gpt-4o
+    instructions: |
+      You are a writing specialist. Take research findings and produce
+      clear, well-structured content.
+    tools: []

package/examples/simple-agent.yaml

@@ -0,0 +1,7 @@
+name: simple-assistant
+description: A simple conversational assistant
+model: openai/gpt-4o
+instructions: |
+  You are a helpful AI assistant. Answer questions clearly and concisely.
+maxTurns: 10
+tools: []

package/go.mod

@@ -0,0 +1,17 @@
+module github.com/agentspan/agentspan/cli
+
+go 1.25.6
+
+require (
+	github.com/fatih/color v1.18.0
+	github.com/spf13/cobra v1.10.2
+	gopkg.in/yaml.v3 v3.0.1
+)
+
+require (
+	github.com/inconshreveable/mousetrap v1.1.0 // indirect
+	github.com/mattn/go-colorable v0.1.13 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/spf13/pflag v1.0.9 // indirect
+	golang.org/x/sys v0.25.0 // indirect
+)

package/go.sum

@@ -0,0 +1,24 @@
+github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
+github.com/fatih/color v1.18.0 h1:S8gINlzdQ840/4pfAwic/ZE0djQEH3wM94VfqLTZcOM=
+github.com/fatih/color v1.18.0/go.mod h1:4FelSpRwEGDpQ12mAdzqdOukCy4u8WUtOY6lkT/6HfU=
+github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8=
+github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw=
+github.com/mattn/go-colorable v0.1.13 h1:fFA4WZxdEF4tXPZVKMLwD8oUnCTTo08duU7wxecdEvA=
+github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg=
+github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
+github.com/spf13/cobra v1.10.2 h1:DMTTonx5m65Ic0GOoRY2c16WCbHxOOw6xxezuLaBpcU=
+github.com/spf13/cobra v1.10.2/go.mod h1:7C1pvHqHw5A4vrJfjNwvOdzYu0Gml16OCs2GRiTUUS4=
+github.com/spf13/pflag v1.0.9 h1:9exaQaMOCwffKiiiYk6/BndUBv+iRViNW+4lEMi0PvY=
+github.com/spf13/pflag v1.0.9/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
+go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=
+golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.25.0 h1:r+8e+loiHxRqhXVl6ML1nO3l1+oFoWbnlu2Ehimmi34=
+golang.org/x/sys v0.25.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

package/install.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+
+// Copyright (c) 2025 AgentSpan
+// Licensed under the MIT License. See LICENSE file in the project root for details.
+
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+
+const S3_BUCKET = 'https://agentspan.s3.us-east-2.amazonaws.com';
+const BINARY_NAME = 'agentspan';
+
+// Detect platform and architecture
+function getPlatform() {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  const platformMap = {
+    darwin: 'darwin',
+    linux: 'linux',
+    win32: 'windows'
+  };
+
+  const archMap = {
+    x64: 'amd64',
+    arm64: 'arm64'
+  };
+
+  if (!platformMap[platform]) {
+    console.error(`Unsupported platform: ${platform}`);
+    process.exit(1);
+  }
+
+  if (!archMap[arch]) {
+    console.error(`Unsupported architecture: ${arch}`);
+    process.exit(1);
+  }
+
+  return {
+    os: platformMap[platform],
+    arch: archMap[arch],
+    isWindows: platform === 'win32'
+  };
+}
+
+// Download binary following redirects
+function downloadBinary(url, dest) {
+  return new Promise((resolve, reject) => {
+    const makeRequest = (requestUrl) => {
+      const mod = requestUrl.startsWith('https') ? https : require('http');
+      mod.get(requestUrl, { headers: { 'User-Agent': 'agentspan-npm-installer' } }, (response) => {
+        if (response.statusCode === 302 || response.statusCode === 301) {
+          makeRequest(response.headers.location);
+          return;
+        }
+
+        if (response.statusCode !== 200) {
+          reject(new Error(`Failed to download: ${response.statusCode}`));
+          return;
+        }
+
+        const file = fs.createWriteStream(dest);
+        response.pipe(file);
+
+        file.on('finish', () => {
+          file.close();
+          resolve();
+        });
+
+        file.on('error', (err) => {
+          fs.unlink(dest, () => {});
+          reject(err);
+        });
+      }).on('error', (err) => {
+        fs.unlink(dest, () => {});
+        reject(err);
+      });
+    };
+
+    makeRequest(url);
+  });
+}
+
+async function install() {
+  try {
+    console.log('Installing AgentSpan CLI...');
+
+    const { os, arch, isWindows } = getPlatform();
+    console.log(`Platform: ${os} ${arch}`);
+
+    const binaryName = isWindows ? `${BINARY_NAME}.exe` : BINARY_NAME;
+    const downloadName = isWindows ? `${BINARY_NAME}_${os}_${arch}.exe` : `${BINARY_NAME}_${os}_${arch}`;
+    const downloadUrl = `${S3_BUCKET}/cli/latest/${downloadName}`;
+
+    console.log(`Downloading from: ${downloadUrl}`);
+
+    // Create bin directory
+    const binDir = path.join(__dirname, 'bin');
+    if (!fs.existsSync(binDir)) {
+      fs.mkdirSync(binDir, { recursive: true });
+    }
+
+    // Download binary
+    const binaryPath = path.join(binDir, binaryName);
+    await downloadBinary(downloadUrl, binaryPath);
+
+    // Make executable (Unix-like systems)
+    if (!isWindows) {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+
+    console.log('Installation successful!');
+    console.log(`Binary installed at: ${binaryPath}`);
+    console.log(`\nRun 'agentspan --help' to get started.`);
+  } catch (error) {
+    console.error('Installation failed:', error.message);
+    process.exit(1);
+  }
+}
+
+install();

package/install.sh

@@ -0,0 +1,104 @@
+#!/bin/sh
+set -e
+
+S3_BUCKET="https://agentspan.s3.us-east-2.amazonaws.com"
+BINARY_NAME="agentspan"
+INSTALL_DIR="${INSTALL_DIR:-/usr/local/bin}"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+detect_os() {
+    OS="$(uname -s)"
+    case "$OS" in
+        Linux*)     OS='linux';;
+        Darwin*)    OS='darwin';;
+        CYGWIN*)    OS='windows';;
+        MINGW*)     OS='windows';;
+        *)
+            echo "${RED}Unsupported operating system: $OS${NC}"
+            exit 1
+            ;;
+    esac
+}
+
+detect_arch() {
+    ARCH="$(uname -m)"
+    case "$ARCH" in
+        x86_64)     ARCH='amd64';;
+        amd64)      ARCH='amd64';;
+        arm64)      ARCH='arm64';;
+        aarch64)    ARCH='arm64';;
+        *)
+            echo "${RED}Unsupported architecture: $ARCH${NC}"
+            exit 1
+            ;;
+    esac
+}
+
+install_binary() {
+    DOWNLOAD_URL="${S3_BUCKET}/cli/latest/${BINARY_NAME}_${OS}_${ARCH}"
+
+    if [ "$OS" = "windows" ]; then
+        DOWNLOAD_URL="${DOWNLOAD_URL}.exe"
+        BINARY_NAME="${BINARY_NAME}.exe"
+    fi
+
+    echo "${YELLOW}Downloading from: $DOWNLOAD_URL${NC}"
+
+    TMP_DIR=$(mktemp -d)
+    TMP_FILE="$TMP_DIR/$BINARY_NAME"
+
+    if ! curl -fsSL "$DOWNLOAD_URL" -o "$TMP_FILE"; then
+        echo "${RED}Failed to download binary${NC}"
+        rm -rf "$TMP_DIR"
+        exit 1
+    fi
+
+    chmod +x "$TMP_FILE"
+
+    if [ -w "$INSTALL_DIR" ]; then
+        mv "$TMP_FILE" "$INSTALL_DIR/$BINARY_NAME"
+        echo "${GREEN}Installed $BINARY_NAME to $INSTALL_DIR${NC}"
+    else
+        echo "${YELLOW}$INSTALL_DIR is not writable. Attempting to use sudo...${NC}"
+        sudo mv "$TMP_FILE" "$INSTALL_DIR/$BINARY_NAME"
+        echo "${GREEN}Installed $BINARY_NAME to $INSTALL_DIR (with sudo)${NC}"
+    fi
+
+    rm -rf "$TMP_DIR"
+}
+
+verify_installation() {
+    if command -v $BINARY_NAME >/dev/null 2>&1; then
+        VERSION_OUTPUT=$($BINARY_NAME version 2>&1 || true)
+        echo "${GREEN}Installation successful!${NC}"
+        echo "${GREEN}  Version: $VERSION_OUTPUT${NC}"
+        echo ""
+        echo "Run '${BINARY_NAME} --help' to get started."
+    else
+        echo "${YELLOW}Binary installed but not found in PATH${NC}"
+        echo "You may need to add $INSTALL_DIR to your PATH:"
+        echo "  export PATH=\"$INSTALL_DIR:\$PATH\""
+    fi
+}
+
+main() {
+    echo "${GREEN}Installing AgentSpan CLI...${NC}"
+    echo ""
+
+    detect_os
+    detect_arch
+
+    echo "Detected OS: $OS"
+    echo "Detected Architecture: $ARCH"
+    echo ""
+
+    install_binary
+    verify_installation
+}
+
+main

package/internal/progress/bar.go

@@ -0,0 +1,121 @@
+// Copyright (c) 2025 AgentSpan
+// Licensed under the MIT License. See LICENSE file in the project root for details.
+
+package progress
+
+import (
+	"fmt"
+	"io"
+	"os"
+	"sync"
+	"time"
+)
+
+const (
+	barWidth       = 30
+	filledChar     = "█"
+	emptyChar      = "░"
+	renderInterval = 100 * time.Millisecond
+)
+
+// ProgressBar tracks and renders download progress to stderr.
+type ProgressBar struct {
+	total      int64
+	current    int64
+	desc       string
+	mu         sync.Mutex
+	lastRender time.Time
+	w          io.Writer
+}
+
+// NewProgressBar creates a new progress bar. If total <= 0, it renders without a bar.
+func NewProgressBar(total int64, desc string) *ProgressBar {
+	return &ProgressBar{
+		total: total,
+		desc:  desc,
+		w:     os.Stderr,
+	}
+}
+
+// Add advances the progress bar by n bytes.
+func (p *ProgressBar) Add(n int64) {
+	p.mu.Lock()
+	defer p.mu.Unlock()
+	p.current += n
+	now := time.Now()
+	if now.Sub(p.lastRender) >= renderInterval {
+		p.render()
+		p.lastRender = now
+	}
+}
+
+// Finish renders the final state with a newline.
+func (p *ProgressBar) Finish() {
+	p.mu.Lock()
+	defer p.mu.Unlock()
+	p.render()
+	fmt.Fprintln(p.w)
+}
+
+func (p *ProgressBar) render() {
+	if p.total > 0 {
+		pct := float64(p.current) / float64(p.total)
+		if pct > 1 {
+			pct = 1
+		}
+		filled := int(pct * float64(barWidth))
+		bar := ""
+		for i := 0; i < barWidth; i++ {
+			if i < filled {
+				bar += filledChar
+			} else {
+				bar += emptyChar
+			}
+		}
+		fmt.Fprintf(p.w, "\r%s  [%s]  %3.0f%%  %s/%s",
+			p.desc, bar, pct*100,
+			FormatBytes(p.current), FormatBytes(p.total))
+	} else {
+		fmt.Fprintf(p.w, "\r%s  %s downloaded", p.desc, FormatBytes(p.current))
+	}
+}
+
+// Reader wraps an io.Reader and reports progress on each Read.
+type Reader struct {
+	reader io.Reader
+	bar    *ProgressBar
+}
+
+// NewReader wraps r with a progress bar. desc is shown as a label.
+// If total <= 0, a simple byte counter is shown instead of a bar.
+func NewReader(r io.Reader, total int64, desc string) (*Reader, *ProgressBar) {
+	bar := NewProgressBar(total, desc)
+	return &Reader{reader: r, bar: bar}, bar
+}
+
+func (r *Reader) Read(p []byte) (int, error) {
+	n, err := r.reader.Read(p)
+	if n > 0 {
+		r.bar.Add(int64(n))
+	}
+	return n, err
+}
+
+// FormatBytes returns a human-readable byte string (e.g. "12.3 MB").
+func FormatBytes(n int64) string {
+	const (
+		kb = 1024
+		mb = 1024 * kb
+		gb = 1024 * mb
+	)
+	switch {
+	case n >= gb:
+		return fmt.Sprintf("%.1f GB", float64(n)/float64(gb))
+	case n >= mb:
+		return fmt.Sprintf("%.1f MB", float64(n)/float64(mb))
+	case n >= kb:
+		return fmt.Sprintf("%.1f KB", float64(n)/float64(kb))
+	default:
+		return fmt.Sprintf("%d B", n)
+	}
+}

package/main.go

@@ -0,0 +1,10 @@
+// Copyright (c) 2025 AgentSpan
+// Licensed under the MIT License. See LICENSE file in the project root for details.
+
+package main
+
+import "github.com/agentspan/agentspan/cli/cmd"
+
+func main() {
+	cmd.Execute()
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@agentspan/agentspan",
+  "version": "0.0.3",
+  "description": "CLI for AgentSpan - Build, run, and manage AI agents",
+  "main": "index.js",
+  "bin": {
+    "agentspan": "./cli.js"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentspan/agentspan.git"
+  },
+  "keywords": [
+    "agentspan",
+    "agent",
+    "ai",
+    "llm",
+    "orchestration",
+    "workflow",
+    "cli"
+  ],
+  "author": "AgentSpan",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/agentspan/agentspan/issues"
+  },
+  "homepage": "https://github.com/agentspan/agentspan#readme",
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=14"
+  }
+}