dist_agent_lang CLI - Complete Command Reference

Version: 1.0.8
Phases Complete: Phase 0–9
Total Commands: 80+ on our way to interactive distributed agents...

Quick Navigation

• Core Commands
• Developer Tools (Phase 0)
• Optimization (Phase 1)
• Blockchain (Phase 2)
• Cryptography (Phase 2)
• Database (Phase 2)
• AI-Enhanced Tools (Phase 3)
• Cloud & Enterprise (Phase 4)
• IDE & LSP (Phase 5)
• Agent Commands (Phase 6)
• AI-IoT (Phase 7)
• Specialized (Phase 8)
• Cross-Component (Phase 9)
• Solidity Tools

Core Commands

Developer Tools (Phase 0)

Code Quality

Project Management

Registry server: Run dal-registry (build with cargo build --bin dal-registry). Env: REGISTRY_STORAGE_PATH, REGISTRY_TOKEN, REGISTRY_PUBLIC_URL, PORT. See PACKAGE_REGISTRY_PLAN.md.

Project Types:

• ai - AI/ML application
• iot - IoT device controller
• agent - Multi-agent system
• chain - Blockchain/smart contract
• web - Web application
• cli - Command-line tool
• lib - Library/package

Interactive Development

Optimization (Phase 1)

Benchmarking

Benchmark Suites:

• lexer - Tokenization performance
• parser - Parsing performance
• runtime - Execution performance
• stdlib - Standard library performance
• all - All suites (default)

Profiling

Optimization

Optimization Levels:

• 0 - None
• 1 - Basic (constant folding, dead code elimination)
• 2 - Aggressive (all optimizations)

Memory

Blockchain (Phase 2)

Chain Information

Supported Chain IDs:

• 1 - Ethereum Mainnet
• 5 - Ethereum Goerli (testnet)
• 137 - Polygon
• 80001 - Polygon Mumbai (testnet)
• 42161 - Arbitrum One
• 56 - Binance Smart Chain

Chain Operations

Asset Management (Local/Simulation)

Cryptography (Phase 2)

Hashing

Hash Algorithms:

• sha256 (default)
• sha512

Key Management

Key Algorithms:

• rsa (default)
• ed25519

Signing & Verification

Encryption

Database (Phase 2)

Connection & Basic Operations

Advanced Operations

Connection String Formats:

• PostgreSQL: postgresql://user:pass@host:port/database
• MySQL: mysql://user:pass@host:port/database
• MongoDB: mongodb://host:port/database

AI-Enhanced Tools (Phase 3)

Code Generation & Analysis

Testing & Optimization

Security

Cloud & Enterprise (Phase 4)

Authorization & Roles

Roles: superadmin, admin, moderator, user

Audit, Policies, Tenant

Compliance & Chain

Hybrid Trust

Env: ADMIN_IDS, ADMIN_LEVEL_<id>, POLICY_<name>_LEVEL

IDE & LSP (Phase 5)

Language Server & Documentation

Shells: bash, zsh, fish

Install completions: dal completions bash >> ~/.bashrc or eval "$(dal completions zsh)"

Agent Commands (Phase 6)

Agent Lifecycle

Types: ai, system, worker, custom:<name>

Communication & Tasks

Note: Agent state is process-local. Use dal run your_agents.dal for multi-agent workflows.

Fleet & Molds

fleet:: stdlib: Use fleet::create, fleet::create_from_mold, fleet::list, fleet::show, fleet::scale, fleet::deploy, fleet::add_from_mold, fleet::add_member, fleet::health in DAL code. See FLEET_DEPLOYMENT.md.

mold:: stdlib: Use mold::load, mold::spawn_from, mold::list, mold::get_info, mold::use_mold in DAL code. See STDLIB_REFERENCE.md.

AI-IoT (Phase 7)

Env: IOT_ANOMALY_API_URL, IOT_ML_API_URL for external APIs.

Specialized (Phase 8)

Cross-Component (Phase 9)

Flows: auth-to-web, oracle-to-chain, chain-to-sync, iot-to-db, iot-to-web, db-to-sync, sync-to-db, ai-to-service, service-to-chain, log-to-sync
Workflows: price-to-deploy, iot-ingest, ai-audit, compliance-check

Flags (bond, pipe, invoke):

• --dry-run — Print planned steps only, do not execute
• --format json — Machine-readable JSON output
• --token <value> — Auth token for HTTP flows (auth-to-web, iot-to-web, ai-to-service, service-to-chain)
• --token-env <VAR> — Read token from environment variable
• --auth-file <path> — Read token from file (first line)

Solidity Tools

Common Workflows

1. Start New Project

dal new my-agent
dal init agent
# write code with @hybrid(centralized) @chain(blockchain)
dal run agent.dal

```bash
dal new my-token --type chain
cd my-token
dal add @dal/testing
dal install
dal fmt src/
dal check src/main.dal
dal run src/main.dal

2. Development Workflow

# Format and check
dal fmt src/
dal lint src/
dal check src/main.dal

# Watch mode for rapid iteration
dal watch src/main.dal

# Or use REPL for experiments
dal repl

3. Performance Optimization

# Profile to find bottlenecks
dal profile app.dal --memory

# Optimize
dal optimize app.dal -o optimized.dal --level 2

# Benchmark to verify improvement
dal bench app.dal
dal bench optimized.dal

4. Blockchain Deployment

# Check gas price
dal chain gas-price 1

# Check balance
dal chain balance 1 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb

# Deploy (via DAL script)
dal run deploy.dal

# Check transaction
dal chain tx-status 1 0xabc123...

5. Cryptographic Operations

# Generate keys
dal crypto keygen ed25519 > keys.txt

# Hash data
dal crypto hash "message" sha256

# Sign and verify
dal crypto sign "msg" "$PRIVATE_KEY" ed25519 > sig.txt
dal crypto verify "msg" "$(cat sig.txt)" "$PUBLIC_KEY" ed25519

6. Database Operations

# Test connection
dal db connect "postgresql://localhost/mydb"

# Explore schema
dal db tables "postgresql://localhost/mydb"
dal db schema "postgresql://localhost/mydb" users

# Query data
dal db query "postgresql://localhost/mydb" "SELECT COUNT(*) FROM users"

# Backup before changes
dal db backup "postgresql://localhost/mydb" pre_migration.sql

# Check performance
dal db metrics "postgresql://localhost/mydb"

7. AI-Assisted Development

# Generate code
dal ai code "Create a DeFi lending protocol" -o lending.dal

# Understand code
dal ai explain lending.dal

# Security audit
dal ai audit lending.dal

# Generate tests
dal ai test lending.dal -o lending.test.dal

# Review and optimize
dal ai review lending.dal
dal ai optimize-gas lending.dal

# Fix issues
dal ai fix lending.dal

Tips & Best Practices

Performance

• Use dal profile --memory to identify memory leaks
• Run dal bench before and after optimizations
• Use dal optimize --level 2 for production builds
• Check dal memory-stats periodically during development

Code Quality

• Always run dal fmt before committing
• Use dal lint to catch common issues
• Run dal check in CI/CD pipelines
• Use dal watch for instant feedback during development

Blockchain

• Check dal chain gas-price before deploying to mainnet
• Verify dal chain balance before transactions
• Use testnets (chain IDs 5, 80001) for development
• Monitor dal chain tx-status after deployment

Cryptography

• Use dal crypto hash for checksums and IDs
• Generate strong keys with dal crypto keygen ed25519
• Use dal crypto aes-encrypt for large data (faster than RSA)
• Never expose private keys in commands (use files or env vars)

Database

• Use dal db plan to optimize slow queries
• Run dal db backup before migrations
• Check dal db metrics to monitor performance
• Use dal db schema to understand table structures

Command Shortcuts

Many commands have short forms or defaults:

Output Formats

All commands support human-readable output by default:

• ✅ Success messages in green
• ❌ Errors in red
• ⚠️ Warnings in yellow
• Emojis for visual clarity

JSON output: Use --format json with bond, pipe, or invoke for machine-readable output.

Exit Codes

Environment Variables

Comparison with Other Tools

Developer Tooling

Blockchain Tools

Crypto Tools

Database Tools

Phase Completion Status

Help & Documentation

# Show main help
dal help

# Show command help (future)
dal chain --help
dal crypto --help
dal db --help

# Version information
dal version

Examples by Use Case

Smart Contract Development

# Create project
dal new token-contract --type chain
cd token-contract

# Format and check
dal fmt src/main.dal
dal check src/main.dal

# Optimize before deployment
dal optimize src/main.dal -o src/optimized.dal --level 2

# Check gas price
dal chain gas-price 1

# Deploy (via script)
dal run deploy.dal

# Verify
dal chain tx-status 1 <tx_hash>

API Development

# Create project
dal new my-api --type web

# Watch mode for development
dal watch src/main.dal

# Benchmark API performance
dal bench src/main.dal

# Profile to find slow endpoints
dal profile src/main.dal --memory

IoT Development

# Create IoT project
dal new smart-device --type iot

# Format and lint
dal fmt src/
dal lint src/main.dal

# Test locally
dal run src/main.dal

# Hash sensor data
dal crypto hash "sensor_reading_123" sha256

Database-Heavy Applications

# Test connection
dal db connect "postgresql://localhost/mydb"

# Explore schema
dal db tables "postgresql://localhost/mydb"
dal db schema "postgresql://localhost/mydb" orders

# Test query
dal db query "postgresql://localhost/mydb" "SELECT COUNT(*) FROM orders"

# Optimize slow query
dal db plan "postgresql://localhost/mydb" "SELECT * FROM orders WHERE user_id = 123"

# Backup before migration
dal db backup "postgresql://localhost/mydb" backup_$(date +%Y%m%d).sql

Key Takeaways

1. Complete Toolchain - DAL has 39 commands covering development, optimization, and operations
2. No External Tools - Everything built into dal CLI
3. Multi-Domain - Blockchain, crypto, database, AI (future) in one tool
4. Developer-Friendly - Clear output, helpful errors, consistent interface
5. Fast Implementation - Phases 1-2 took ~3-4 hours total (backend already existed)

DAL is now competitive with mature toolchains like cargo, go, and npm, while adding blockchain-native and AI-powered features that no other language has.

For detailed documentation on each phase:

• Phase 0 Complete
• Phase 1 Complete
• Phase 2 Complete
• Phase 3 Complete
• Phase 4 Complete
• Phase 5 Complete
• Phase 6 Complete
• Phases 7, 8, 9 Complete