agentopology 0.1.0

package/dist/visualizer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/visualizer/index.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAm6CV,CAAC;AAEF,8EAA8E"}

package/examples/code-review.at

@@ -0,0 +1,167 @@
+# code-review.at — Automated code review with fan-out
+#
+# Demonstrates: fan-out pattern, advisory agents, skip conditions,
+#               multiple output enums, parallel execution
+
+topology code-review : [pipeline, fan-out, human-gate] {
+
+  meta {
+    version: "1.0.0"
+    description: "Automated code review — analyze, scan, review, and approve"
+  }
+
+  providers {
+    anthropic {
+      api-key: "${ANTHROPIC_API_KEY}"
+      models: [opus, sonnet, haiku]
+      default: true
+    }
+  }
+
+  orchestrator {
+    model: opus
+    generates: "commands/review.md"
+    handles: [intake, create-report]
+  }
+
+  roles {
+    analyzer: "Static analysis — complexity, dependencies, blast radius"
+    security: "Security vulnerability scanning and OWASP checks"
+    reviewer: "Holistic code review — logic, style, test coverage"
+    reporter: "Compile findings into a structured review report"
+  }
+
+  # --- Actions ---
+
+  action intake {
+    kind: external
+    source: "github-pr"
+    description: "Fetch PR diff and metadata from GitHub"
+  }
+
+  action create-report {
+    kind: report
+    description: "Compile all findings into final review report"
+  }
+
+  # --- Agents ---
+
+  agent analyzer {
+    role: analyzer
+    model: sonnet
+    permissions: supervised
+    prompt: "prompts/analyzer.md"
+    phase: 1
+    tools: [Read, Grep, Glob]
+    reads: ["workspace/pr-diff.md"]
+    writes: ["workspace/analysis.md"]
+    outputs: {
+      risk-level: low | medium | high | critical
+    }
+  }
+
+  agent security-scanner {
+    role: security
+    model: sonnet
+    permissions: supervised
+    prompt: "prompts/security-scanner.md"
+    phase: 1
+    tools: [Read, Grep, Glob]
+    reads: ["workspace/pr-diff.md"]
+    writes: ["workspace/security.md"]
+    behavior: advisory
+    outputs: {
+      has-vulnerabilities: yes | no
+    }
+  }
+
+  agent reviewer {
+    role: reviewer
+    model: opus
+    permissions: supervised
+    prompt: "prompts/reviewer.md"
+    phase: 2
+    tools: [Read, Grep, Glob]
+    reads: ["workspace/pr-diff.md", "workspace/analysis.md", "workspace/security.md"]
+    writes: ["workspace/review.md"]
+    outputs: {
+      verdict: approve | request-changes | reject
+    }
+  }
+
+  agent reporter {
+    role: reporter
+    model: haiku
+    permissions: autonomous
+    prompt: "prompts/reporter.md"
+    phase: 3
+    tools: [Read, Write, Glob]
+    reads: ["workspace/analysis.md", "workspace/security.md", "workspace/review.md"]
+    writes: ["workspace/final-report.md"]
+  }
+
+  # --- Flow ---
+  #
+  # Fan-out: analyzer and security-scanner run in parallel after intake.
+  # Both feed into reviewer. Reporter compiles the final output.
+
+  flow {
+    intake -> [analyzer, security-scanner]
+    analyzer -> reviewer
+    security-scanner -> reviewer
+    reviewer -> reporter           [when reviewer.verdict == approve]
+    reviewer -> reporter           [when reviewer.verdict == request-changes]
+    reviewer -> create-report      [when reviewer.verdict == reject]
+    reporter -> create-report
+  }
+
+  # --- Gates ---
+
+  gates {
+    gate human-approval {
+      after: reviewer
+      before: reporter
+      run: "scripts/human-approve.sh"
+      on-fail: halt
+    }
+  }
+
+  # --- Memory ---
+
+  memory {
+    workspace {
+      path: "workspace/"
+      structure: [pr-diff, analysis, security, review, reports]
+    }
+  }
+
+  # --- Triggers ---
+
+  triggers {
+    command review {
+      pattern: "/review <PR_URL>"
+      argument: PR_URL
+    }
+
+    command audit {
+      pattern: "/audit"
+    }
+  }
+
+  # --- Hooks ---
+
+  hooks {
+    hook log-findings {
+      on: AgentStop
+      run: "scripts/log-findings.sh"
+      type: command
+    }
+  }
+
+  # --- Settings ---
+
+  settings {
+    allow: ["Read", "Grep", "Glob"]
+    deny: ["Write", "Edit", "Bash"]
+  }
+}

package/examples/data-processing.at

@@ -0,0 +1,296 @@
+# data-processing.at — Batch data processing pipeline
+#
+# Demonstrates: scale blocks, custom tools, batch processing, metering,
+#               parallel extractors, MCP servers, environments
+
+topology data-processing : [pipeline, fan-out] {
+
+  meta {
+    version: "1.0.0"
+    description: "Batch data processing — ingest, extract, classify, and generate reports"
+  }
+
+  providers {
+    anthropic {
+      api-key: "${ANTHROPIC_API_KEY}"
+      models: [opus, sonnet, haiku]
+      default: true
+    }
+  }
+
+  orchestrator {
+    model: opus
+    generates: "commands/process.md"
+    handles: [ingest, validate-batch, deliver]
+    outputs: {
+      batch-mode: streaming | bulk
+    }
+  }
+
+  roles {
+    extractor: "Multi-format text extraction from raw documents"
+    classifier: "Score and categorize extracted documents"
+    synthesizer: "Merge classified results into structured output"
+    reporter: "Generate human-readable reports from synthesis"
+  }
+
+  # --- Custom Tools ---
+
+  tools {
+    tool extract-pdf {
+      script: "scripts/extract-pdf.py"
+      args: [input-path, output-path]
+      lang: python
+      description: "Extract text from PDF documents"
+    }
+
+    tool extract-doc {
+      script: "scripts/extract-doc.py"
+      args: [input-path, output-path]
+      lang: python
+      description: "Extract text from DOC/DOCX files"
+    }
+
+    tool merge-results {
+      script: "scripts/merge-results.sh"
+      args: [input-dir, output-file]
+      lang: bash
+      description: "Merge classified results into a single output"
+    }
+
+    tool validate-output {
+      script: "scripts/validate-output.py"
+      args: [output-file, schema-path]
+      lang: python
+      description: "Validate output against expected schema"
+    }
+  }
+
+  # --- Skills ---
+
+  skill extraction {
+    description: "Document extraction -- PDF, DOC, images"
+    scripts: [extract-pdf, extract-doc]
+  }
+
+  skill classification {
+    description: "Document scoring and categorization"
+    scripts: [validate-output]
+    domains: ["domains/scoring-rubric.md"]
+  }
+
+  # --- Actions ---
+
+  action ingest {
+    kind: external
+    source: "s3-bucket"
+    description: "Pull raw documents from the input bucket"
+  }
+
+  action validate-batch {
+    kind: inline
+    description: "Validate batch completeness before synthesis"
+  }
+
+  action deliver {
+    kind: report
+    description: "Deliver final reports to output bucket"
+  }
+
+  # --- Agents ---
+
+  agent extractor {
+    role: extractor
+    model: sonnet
+    permissions: autonomous
+    prompt: "prompts/extractor.md"
+    phase: 1
+    tools: [Read, Write, extract-pdf, extract-doc]
+    skills: [extraction]
+    reads: ["workspace/raw/"]
+    writes: ["workspace/extracted/"]
+    background: true
+    scale {
+      mode: auto
+      by: doc-count
+      min: 2
+      max: 8
+      batch-size: 50
+    }
+  }
+
+  agent classifier {
+    role: classifier
+    model: haiku
+    permissions: autonomous
+    prompt: "prompts/classifier.md"
+    phase: 2
+    tools: [Read, Write, validate-output]
+    skills: [classification]
+    reads: ["workspace/extracted/"]
+    writes: ["workspace/classified/"]
+    background: true
+    scale {
+      mode: auto
+      by: batch-count
+      min: 2
+      max: 12
+      batch-size: 25
+    }
+  }
+
+  agent synthesizer {
+    role: synthesizer
+    model: opus
+    permissions: autonomous
+    prompt: "prompts/synthesizer.md"
+    phase: 3
+    tools: [Read, Write, merge-results]
+    reads: ["workspace/classified/"]
+    writes: ["workspace/synthesis.json"]
+  }
+
+  agent reporter {
+    role: reporter
+    model: sonnet
+    permissions: autonomous
+    prompt: "prompts/reporter.md"
+    phase: 4
+    tools: [Read, Write]
+    reads: ["workspace/synthesis.json"]
+    writes: ["workspace/report.md", "workspace/report.pdf"]
+    outputs: {
+      quality: complete | partial | failed
+    }
+  }
+
+  # --- Flow ---
+
+  flow {
+    ingest -> extractor
+    extractor -> classifier
+    classifier -> validate-batch
+    validate-batch -> synthesizer
+    synthesizer -> reporter
+    reporter -> deliver           [when reporter.quality == complete]
+    reporter -> deliver           [when reporter.quality == partial]
+    reporter -> synthesizer       [when reporter.quality == failed, max 2]
+  }
+
+  # --- Gates ---
+
+  gates {
+    gate schema-validation {
+      after: synthesizer
+      before: reporter
+      run: "scripts/validate-schema.sh"
+      checks: [schema, completeness, consistency]
+      retry: 2
+      on-fail: bounce-back
+    }
+  }
+
+  # --- Batch ---
+
+  batch {
+    parallel: true
+    per: ticket
+    conflicts: {
+      detect: ["workspace/synthesis.json"]
+      resolve: sequential-rebase
+    }
+    workspace: "runs/_batch/{BATCH_ID}/"
+  }
+
+  # --- Memory ---
+
+  memory {
+    workspace {
+      path: "workspace/"
+      protocol: "workspace-protocol.md"
+      structure: [raw, extracted, classified, synthesis, reports]
+    }
+
+    metrics {
+      path: "metrics/processing.jsonl"
+      mode: append-only
+    }
+  }
+
+  # --- Metering ---
+
+  metering {
+    track: [tokens-in, tokens-out, cost, wall-time, agent-count]
+    per: [phase, agent, run]
+    output: "metrics/"
+    format: jsonl
+    pricing: none
+  }
+
+  # --- Environments ---
+
+  environments {
+    development {
+      bucket: "dev-input-bucket"
+      output-bucket: "dev-output-bucket"
+    }
+
+    production {
+      bucket: "prod-input-bucket"
+      output-bucket: "prod-output-bucket"
+    }
+  }
+
+  # --- Triggers ---
+
+  triggers {
+    command process {
+      pattern: "/process <BATCH_ID>"
+      argument: BATCH_ID
+    }
+
+    command status {
+      pattern: "/status"
+    }
+  }
+
+  # --- Hooks ---
+
+  hooks {
+    hook track-progress {
+      on: AgentStop
+      run: "scripts/track-progress.sh"
+      type: command
+    }
+
+    hook security-check {
+      on: ToolUse
+      matcher: "Bash"
+      run: "scripts/security-check.sh"
+      type: command
+    }
+  }
+
+  # --- MCP Servers ---
+
+  mcp-servers {
+    storage {
+      type: stdio
+      command: "npx"
+      args: ["-y", "storage-mcp-server"]
+    }
+
+    monitoring {
+      type: http
+      url: "https://mcp.monitoring.example.com"
+    }
+  }
+
+  # --- Settings ---
+
+  settings {
+    allow: ["Read", "Write", "Glob", "Grep"]
+    deny: ["Bash(rm -rf *)"]
+    ask: ["Bash(aws s3 *)"]
+  }
+}

package/examples/openclaw-assistant.at

@@ -0,0 +1,142 @@
+# OpenClaw showcase — personal assistant with multi-channel support
+
+topology personal-assistant : [supervisor, fan-out] {
+
+  meta {
+    version: "1.0.0"
+    description: "Multi-channel personal assistant with research, writing, and scheduling capabilities"
+    domain: "productivity"
+  }
+
+  orchestrator {
+    model: opus
+    handles: [intake, route]
+    outputs: {
+      task-type: research | write | schedule | general
+    }
+  }
+
+  roles {
+    researcher: "Deep research using web search and document analysis"
+    writer: "Draft emails, messages, and documents in user's voice"
+    scheduler: "Manage calendar and schedule meetings"
+    responder: "Handle general questions and conversation"
+  }
+
+  action intake {
+    kind: inline
+    description: "Parse user request — extract task type"
+  }
+
+  action route {
+    kind: inline
+    description: "Route to appropriate specialist agent based on task-type"
+  }
+
+  agent researcher {
+    role: researcher
+    model: sonnet
+    phase: 1
+    tools: [Read, Write, Bash, Glob, Grep, WebSearch, WebFetch]
+    reads: ["workspace/queries/"]
+    writes: ["workspace/research/"]
+    max-turns: 15
+    description: "Research agent — searches web, reads docs, produces summaries"
+  }
+
+  agent writer {
+    role: writer
+    model: sonnet
+    phase: 1
+    tools: [Read, Write, Edit]
+    writes: ["workspace/drafts/"]
+    description: "Writing agent — drafts in user's voice using research output"
+  }
+
+  agent scheduler {
+    role: scheduler
+    model: haiku
+    phase: 1
+    tools: [Read, Write]
+    skills: [google-calendar]
+    reads: ["workspace/requests/"]
+    writes: ["workspace/scheduled/"]
+    description: "Calendar agent — checks availability, proposes meeting times"
+    extensions {
+      openclaw {
+        calendar-integration: true
+      }
+    }
+  }
+
+  agent responder {
+    role: responder
+    model: sonnet
+    phase: 1
+    tools: [Read, Write]
+    reads: ["domains/"]
+    writes: ["workspace/responses/"]
+    description: "General responder for conversation and simple questions"
+  }
+
+  flow {
+    intake -> route
+    route -> researcher   [when orchestrator.task-type == research]
+    route -> writer       [when orchestrator.task-type == write]
+    route -> scheduler    [when orchestrator.task-type == schedule]
+    route -> responder    [when orchestrator.task-type == general]
+  }
+
+  memory {
+    domains {
+      path: "domains/"
+      routing: "FILE_MAP.md"
+    }
+    workspace {
+      path: "workspace/"
+      structure: [queries, research, drafts, requests, scheduled, responses]
+    }
+    metrics {
+      path: "metrics.jsonl"
+      mode: append-only
+    }
+  }
+
+  providers {
+    anthropic {
+      api-key: "${ANTHROPIC_API_KEY}"
+      models: [opus, sonnet, haiku]
+      default: true
+    }
+  }
+
+  settings {
+    allow: [Read, Write, Edit, Glob, Grep]
+    deny: []
+  }
+
+  metering {
+    track: [tokens-in, tokens-out, cost, wall-time]
+    per: [agent, run]
+    output: "metrics/"
+    format: jsonl
+    pricing: anthropic-current
+  }
+
+  extensions {
+    openclaw {
+      gateway-port: 18789
+      auth-tokens: ["${OPENCLAW_AUTH_TOKEN}"]
+      channels: [telegram, slack]
+      telegram: {
+        bot-token: "${TELEGRAM_BOT_TOKEN}"
+        dm-policy: "pairing"
+      }
+      slack: {
+        app-token: "${SLACK_APP_TOKEN}"
+        bot-token: "${SLACK_BOT_TOKEN}"
+      }
+      model-fallback-chain: ["opus", "sonnet", "haiku"]
+    }
+  }
+}