@dot-agent/cli 1.0.1 → 1.0.2

package/src/cli.ts

@@ -1,111 +0,0 @@
-#!/usr/bin/env node
-
-// Copyright 2026 Danilo Borges
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import { init, pack, unpack, run } from './index.js'
-
-const args = process.argv.slice(2)
-const command = args[0]
-
-function formatError(msg: string) {
-  const lines = msg.split('\n')
-  console.error(`\x1b[31m✗\x1b[0m ${lines[0]}`)
-  if (lines.length > 1) {
-    lines.slice(1).forEach(line => console.error(`  ${line}`))
-  }
-}
-
-function formatSuccess(msg: string) {
-  console.log(`\x1b[32m✓\x1b[0m ${msg}`)
-}
-
-function formatWarning(msg: string) {
-  console.warn(`\x1b[33m⚠\x1b[0m ${msg}`)
-}
-
-async function main() {
-  try {
-    if (command === 'init') {
-      const options: any = {}
-      for (let i = 1; i < args.length; i++) {
-        if (args[i] === '--name' && i + 1 < args.length) options.name = args[++i]
-        if (args[i] === '--domain' && i + 1 < args.length) options.domain = args[++i]
-        if (args[i] === '--dir' && i + 1 < args.length) options.dir = args[++i]
-      }
-
-      const result = await init(options)
-      formatSuccess(`Scaffolded agent project in ${result.dir}`)
-      console.log(`  Files: ${result.files.join(', ')}`)
-    } else if (command === 'pack') {
-      const options: any = {}
-      for (let i = 1; i < args.length; i++) {
-        if (args[i] === '--dir' && i + 1 < args.length) options.dir = args[++i]
-        if (args[i] === '--out' && i + 1 < args.length) options.out = args[++i]
-        if (args[i] === '--commit' && i + 1 < args.length) options.commit = args[++i]
-        if (args[i] === '--version' && i + 1 < args.length) options.version = args[++i]
-      }
-
-      const result = await pack(options)
-      formatSuccess(`Packed → ${result.path}`)
-      console.log(`  ID: ${result.id}`)
-      if (result.warnings.length > 0) {
-        console.log(`  Warnings: ${result.warnings.length}`)
-        result.warnings.forEach(w => {
-          formatWarning(`${w.file}:${w.line}:${w.col} ${w.code} ${w.message}`)
-        })
-      }
-    } else if (command === 'unpack') {
-      const file = args[1]
-      if (!file) {
-        formatError('Usage: dot-agent unpack <file.agent> [--out <dir>] [--force]')
-        process.exit(1)
-      }
-
-      const options: any = { file }
-      for (let i = 2; i < args.length; i++) {
-        if (args[i] === '--out' && i + 1 < args.length) options.out = args[++i]
-        if (args[i] === '--force') options.force = true
-      }
-
-      const result = await unpack(options)
-      formatSuccess(`Unpacked to ${result.dir}`)
-      console.log(`  ID: ${result.id}`)
-      console.log(`  Files: ${result.files.length}`)
-    } else if (command === 'run') {
-      const source = args[1]
-      if (!source) {
-        formatError('Usage: dot-agent run <file.agent | dir>')
-        process.exit(1)
-      }
-
-      const context = await run({ source })
-      formatSuccess(`Agent loaded: ${context.id}`)
-    } else {
-      console.log(`dot-agent CLI v1.0.0
-
-Usage:
-  dot-agent init [--name <name>] [--domain <domain>] [--dir <dir>]
-  dot-agent pack [--dir <dir>] [--out <file>] [--commit <hash>] [--version <tag>]
-  dot-agent unpack <file.agent> [--out <dir>] [--force]
-  dot-agent run <file.agent | dir>
-`)
-    }
-  } catch (err: any) {
-    formatError(err.message)
-    process.exit(1)
-  }
-}
-
-main()

package/src/commands/init.ts

@@ -1,117 +0,0 @@
-// Copyright 2026 Danilo Borges
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import { mkdir, writeFile, stat } from 'fs/promises'
-import { join, basename } from 'path'
-import { InitOptions, InitResult } from '../types.js'
-
-const AGENT_DESCRIPTION_TEMPLATE = (name: string, domain: string) => `agent ${name}
-  domain ${domain}
-  license Apache-2.0
-
-description
-  Describe what this agent does.
-
-behavior agent.behavior
-
-capabilities
-  ActionName "Describe this capability"
-`
-
-const AGENT_BEHAVIOR_TEMPLATE = `state init
-  transition to responsive
-
-state responsive
-  goal "Help the user with their task."
-  interact
-  on intent "start" transition to responsive
-`
-
-const SOUL_TEMPLATE = (name: string) => `# ${name} — Persona
-
-## Voice and Tone
-
-Describe the agent's voice, personality, and communication style.
-`
-
-const README_TEMPLATE = (name: string) => `# ${name}
-
-Brief description of what this agent does.
-
-## Usage
-
-Example of how to use this agent.
-`
-
-const LICENSE = `Apache License
-Version 2.0, January 2004
-
-http://www.apache.org/licenses/
-
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-`
-
-export async function init(options: InitOptions = {}): Promise<InitResult> {
-  const dir = options.dir || process.cwd()
-  const name = options.name || basename(dir)
-  const domain = options.domain || 'example.com'
-
-  try {
-    await stat(dir)
-  } catch {
-    await mkdir(dir, { recursive: true })
-  }
-
-  const agentDescriptionPath = join(dir, 'agent.description')
-  try {
-    await stat(agentDescriptionPath)
-    throw new Error(`agent.description already exists at ${agentDescriptionPath}`)
-  } catch (err: any) {
-    if (err.code !== 'ENOENT') throw err
-  }
-
-  const files: string[] = []
-
-  await writeFile(agentDescriptionPath, AGENT_DESCRIPTION_TEMPLATE(name, domain))
-  files.push('agent.description')
-
-  await writeFile(join(dir, 'agent.behavior'), AGENT_BEHAVIOR_TEMPLATE)
-  files.push('agent.behavior')
-
-  await writeFile(join(dir, 'SOUL.md'), SOUL_TEMPLATE(name))
-  files.push('SOUL.md')
-
-  await writeFile(join(dir, 'README.md'), README_TEMPLATE(name))
-  files.push('README.md')
-
-  await writeFile(join(dir, 'LICENSE'), LICENSE)
-  files.push('LICENSE')
-
-  await mkdir(join(dir, 'behaviors'), { recursive: true })
-  await writeFile(join(dir, 'behaviors', '.gitkeep'), '')
-  files.push('behaviors/.gitkeep')
-
-  await mkdir(join(dir, 'guides'), { recursive: true })
-  await writeFile(join(dir, 'guides', '.gitkeep'), '')
-  files.push('guides/.gitkeep')
-
-  await mkdir(join(dir, 'knowledge'), { recursive: true })
-  await writeFile(join(dir, 'knowledge', '.gitkeep'), '')
-  files.push('knowledge/.gitkeep')
-
-  await writeFile(join(dir, 'AGENTS.md'), '')
-  files.push('AGENTS.md')
-
-  return { dir, files }
-}

package/src/commands/pack.ts

@@ -1,230 +0,0 @@
-// Copyright 2026 Danilo Borges
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import { readFile, stat, readdir } from 'fs/promises'
-import { join, basename, dirname } from 'path'
-import { execSync } from 'child_process'
-import { createHash } from 'crypto'
-import JSZip from 'jszip'
-import { PackOptions, PackResult, LintMessage } from '../types.js'
-import { createLinter } from '../core/lint.js'
-import { buildId } from '../core/id.js'
-import { buildAboutme, aboutmeToJson } from '../core/envelope.js'
-import { buildTypesJson } from '../core/types.js'
-import { writeZip } from '../core/zip.js'
-
-function gitDescribeTags(): string | null {
-  try {
-    return execSync('git describe --tags --abbrev=0', {
-      stdio: 'pipe',
-      encoding: 'utf-8',
-    }).trim()
-  } catch {
-    return null
-  }
-}
-
-function gitRevParseShort(): string | null {
-  try {
-    return execSync('git rev-parse --short HEAD', {
-      stdio: 'pipe',
-      encoding: 'utf-8',
-    }).trim()
-  } catch {
-    return null
-  }
-}
-
-async function resolveVersion(explicit?: string): Promise<string> {
-  if (explicit) return explicit
-
-  const gitTag = gitDescribeTags()
-  if (gitTag) return gitTag
-
-  return 'v1.0.0'
-}
-
-async function resolveCommit(explicit?: string): Promise<string | undefined> {
-  if (explicit) return explicit
-  return gitRevParseShort() || undefined
-}
-
-async function collectFiles(dir: string): Promise<Map<string, string>> {
-  const files = new Map<string, string>()
-
-  async function walk(subdir: string, prefix: string = '') {
-    try {
-      const entries = await readdir(subdir)
-      for (const entry of entries) {
-        if (entry === '.gitkeep' || entry.startsWith('.')) continue
-
-        const fullPath = join(subdir, entry)
-        const stats = await stat(fullPath)
-        const relativePath = prefix ? `${prefix}/${entry}` : entry
-
-        if (stats.isDirectory()) {
-          await walk(fullPath, relativePath)
-        } else {
-          const content = await readFile(fullPath, 'utf-8')
-          files.set(relativePath, content)
-        }
-      }
-    } catch {
-      // directory doesn't exist or can't be read
-    }
-  }
-
-  const description = await readFile(join(dir, 'agent.description'), 'utf-8')
-  files.set('agent.description', description)
-
-  const behavior = await readFile(join(dir, 'agent.behavior'), 'utf-8')
-  files.set('agent.behavior', behavior)
-
-  try {
-    const soul = await readFile(join(dir, 'SOUL.md'), 'utf-8')
-    files.set('SOUL.md', soul)
-  } catch {
-    // optional
-  }
-
-  await walk(join(dir, 'behaviors'), 'behaviors')
-  await walk(join(dir, 'guides'), 'guides')
-  await walk(join(dir, 'knowledge'), 'knowledge')
-
-  return files
-}
-
-function parseDescription(text: string): any {
-  const domain = text.match(/domain\s+([^\n]+)/)?.[1] || ''
-  const name = text.match(/agent\s+([^\n]+)/)?.[1] || ''
-  const description = text.match(/description\s+(.+?)(?=\n\n|\n[a-z])/s)?.[1] || ''
-
-  return {
-    domain: domain.trim(),
-    name: name.trim(),
-    description: description.trim(),
-    capabilities: [],
-  }
-}
-
-export async function pack(options: PackOptions = {}): Promise<PackResult> {
-  const dir = options.dir || process.cwd()
-  const outPath = options.out || join(dir, `${basename(dir)}.agent`)
-
-  // Read files
-  let descriptionText: string
-  let behaviorText: string
-
-  try {
-    descriptionText = await readFile(join(dir, 'agent.description'), 'utf-8')
-  } catch {
-    throw new Error('E003: File agent.description not found')
-  }
-
-  try {
-    behaviorText = await readFile(join(dir, 'agent.behavior'), 'utf-8')
-  } catch {
-    throw new Error('E007: File agent.behavior not found')
-  }
-
-  // Lint
-  const linter = await createLinter()
-  const descriptionMessages = await linter.lintDescription(descriptionText)
-  const behaviorMessages = await linter.lintBehavior(behaviorText)
-
-  const allMessages = [...descriptionMessages, ...behaviorMessages]
-  const errors = allMessages.filter(m => m.severity === 'error')
-  const warnings = allMessages.filter(m => m.severity === 'warning')
-
-  if (errors.length > 0) {
-    throw new Error(`Lint failed: ${errors.map(e => `${e.file}:${e.line}:${e.col} ${e.code} ${e.message}`).join('\n')}`)
-  }
-
-  // Parse description
-  const description = parseDescription(descriptionText)
-
-  // Resolve version & commit
-  const version = await resolveVersion(options.version)
-  const commit = await resolveCommit(options.commit)
-
-  // Collect all files
-  const allFiles = await collectFiles(dir)
-
-  // Build ID
-  const contentForHash = Array.from(allFiles.values()).join('')
-  const digest = createHash('sha256').update(contentForHash).digest('hex').substring(0, 8)
-  const id = buildId({
-    namespace: description.domain,
-    name: description.name,
-    version,
-    digest,
-  })
-
-  // Build aboutme
-  const aboutme = buildAboutme({
-    id,
-    name: description.name,
-    description: description.description,
-    version,
-    domain: description.domain,
-    license: 'Apache-2.0',
-    persona: 'SOUL.md',
-    compiler: 'dot-agent/1.0.0',
-    commit,
-    skills: [],
-    requires: [],
-    integrity: {
-      sha256: createHash('sha256').update(contentForHash).digest('hex'),
-      files: '.agent/files.json',
-    },
-  })
-
-  // Build ZIP
-  const zip = new JSZip()
-
-  zip.folder('.agent')!.file('aboutme.json', aboutmeToJson(aboutme))
-
-  // Build files.json
-  const filesJson = {
-    description: 'agent.description',
-    behavior: 'agent.behavior',
-    behaviors: Array.from(allFiles.keys())
-      .filter(f => f.startsWith('behaviors/') && f !== 'behaviors/.gitkeep')
-      .map(f => f),
-    guides: Array.from(allFiles.keys())
-      .filter(f => f.startsWith('guides/') && f !== 'guides/.gitkeep')
-      .map(f => f),
-    knowledge: Array.from(allFiles.keys())
-      .filter(f => f.startsWith('knowledge/') && f !== 'knowledge/.gitkeep')
-      .map(f => f),
-  }
-
-  zip.folder('.agent')!.file('files.json', JSON.stringify(filesJson, null, 2))
-
-  // Add all files to ZIP root
-  for (const [path, content] of allFiles) {
-    if (path !== 'behaviors/.gitkeep' && path !== 'guides/.gitkeep' && path !== 'knowledge/.gitkeep') {
-      zip.file(path, content)
-    }
-  }
-
-  // Write ZIP
-  await writeZip(zip, outPath)
-
-  return {
-    path: outPath,
-    id,
-    warnings,
-  }
-}

package/src/commands/run.ts

@@ -1,208 +0,0 @@
-// Copyright 2026 Danilo Borges
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import { EventEmitter } from 'events'
-import { readFile, stat } from 'fs/promises'
-import { AgentDSLKernel, init as initKernel } from '@dot-agent/kernel-dsl'
-import { RunOptions, AgentContext, FileEntry } from '../types.js'
-import { readZip, validateZipBomb, validateMagicBytes, extractFiles } from '../core/zip.js'
-import { parseAboutme } from '../core/envelope.js'
-
-function isZipFile(source: string): boolean {
-  return source.endsWith('.agent')
-}
-
-export async function run(options: RunOptions): Promise<AgentContext> {
-  const { source } = options
-  const context = new EventEmitter() as any as AgentContext
-
-  try {
-    context.emit('progress', { step: 'opening', pct: 0 })
-
-    let descriptionText: string
-    let behaviorText: string
-    let aboutme: any = null
-    let id: string
-
-    if (isZipFile(source)) {
-      // Load from .agent ZIP
-      await validateMagicBytes(source)
-      await validateZipBomb(source)
-
-      const zip = await readZip(source)
-
-      const aboutmeFile = zip.file('.agent/aboutme.json')
-      if (!aboutmeFile) {
-        throw new Error('Missing .agent/aboutme.json')
-      }
-
-      const aboutmeText = await aboutmeFile.async('text')
-      aboutme = parseAboutme(JSON.parse(aboutmeText))
-      id = aboutme.id
-
-      const descFile = zip.file('agent.description')
-      if (!descFile) throw new Error('Missing agent.description')
-      descriptionText = await descFile.async('text')
-
-      const behavFile = zip.file('agent.behavior')
-      if (!behavFile) throw new Error('Missing agent.behavior')
-      behaviorText = await behavFile.async('text')
-
-      context.emit('progress', { step: 'parsing', pct: 30 })
-
-      // Load kernel-dsl
-      let kernel: any
-      try {
-        await initKernel()
-        kernel = new AgentDSLKernel()
-        kernel.load_behavior(behaviorText)
-      } catch (err: any) {
-        // Kernel failed - create a stub
-        kernel = {
-          get_current_state: () => 'init',
-          get_graph: () => ({}),
-          get_memory: () => [],
-          get_valid_intents: () => [],
-          load_behavior: () => {},
-          observe: () => {},
-          send_complete: () => {},
-          send_event: () => {},
-          send_failed: () => {},
-          send_fallback: () => {},
-          send_intent: () => {},
-          send_offtopic: () => {},
-          tick_prompt: () => {},
-          free: () => {},
-        }
-      }
-
-      context.emit('progress', { step: 'loading-files', pct: 60 })
-
-      // Load files
-      const soulFile = zip.file('SOUL.md')
-      const soul = soulFile ? await soulFile.async('text') : undefined
-
-      const allFiles = await extractFiles(zip)
-      const guides: FileEntry[] = []
-      const knowledge: FileEntry[] = []
-      const behaviors: FileEntry[] = []
-
-      for (const [path, content] of allFiles) {
-        if (path.startsWith('guides/') && path !== 'guides/.gitkeep') {
-          guides.push({ path, content })
-        } else if (path.startsWith('knowledge/') && path !== 'knowledge/.gitkeep') {
-          knowledge.push({ path, content })
-        } else if (path.startsWith('behaviors/') && path !== 'behaviors/.gitkeep') {
-          behaviors.push({ path, content })
-        }
-      }
-
-      context.id = id
-      context.description = { domain: 'example.com', name: 'Agent' }
-      context.behavior = {}
-      context.kernel = kernel
-      context.files = { soul, guides, knowledge, behaviors }
-      context.aboutme = aboutme
-    } else {
-      // Load from directory
-      const descPath = `${source}/agent.description`
-      const behavPath = `${source}/agent.behavior`
-
-      try {
-        descriptionText = await readFile(descPath, 'utf-8')
-      } catch {
-        throw new Error(`Missing agent.description at ${descPath}`)
-      }
-
-      try {
-        behaviorText = await readFile(behavPath, 'utf-8')
-      } catch {
-        throw new Error(`Missing agent.behavior at ${behavPath}`)
-      }
-
-      context.emit('progress', { step: 'parsing', pct: 30 })
-
-      // Load kernel-dsl
-      let kernel: any
-      try {
-        await initKernel()
-        kernel = new AgentDSLKernel()
-        kernel.load_behavior(behaviorText)
-      } catch (err: any) {
-        // Kernel failed - create a stub
-        kernel = {
-          get_current_state: () => 'init',
-          get_graph: () => ({}),
-          get_memory: () => [],
-          get_valid_intents: () => [],
-          load_behavior: () => {},
-          observe: () => {},
-          send_complete: () => {},
-          send_event: () => {},
-          send_failed: () => {},
-          send_fallback: () => {},
-          send_intent: () => {},
-          send_offtopic: () => {},
-          tick_prompt: () => {},
-          free: () => {},
-        }
-      }
-
-      context.emit('progress', { step: 'loading-files', pct: 60 })
-
-      id = 'local/agent:v1.0~unknown'
-
-      try {
-        const soul = await readFile(`${source}/SOUL.md`, 'utf-8')
-        context.files = {
-          soul,
-          guides: [],
-          knowledge: [],
-          behaviors: [],
-        }
-      } catch {
-        context.files = { guides: [], knowledge: [], behaviors: [] }
-      }
-
-      const defaultAboutme: any = {
-        schemaVersion: 'dot-agent/1.0',
-        id,
-        name: 'Agent',
-        description: '',
-        version: 'v1.0',
-        domain: 'local',
-        license: 'Apache-2.0',
-        persona: 'SOUL.md',
-        compiler: 'dot-agent/1.0.0',
-        skills: [],
-        requires: [],
-        integrity: { sha256: '', files: '' },
-      }
-
-      context.id = id
-      context.description = { domain: 'example.com', name: 'Agent' }
-      context.behavior = {}
-      context.kernel = kernel
-      context.aboutme = defaultAboutme
-    }
-
-    context.emit('progress', { step: 'ready', pct: 100 })
-    context.emit('ready', context)
-
-    return context
-  } catch (err) {
-    context.emit('error', err)
-    throw err
-  }
-}