DK Agent OS (Release 1.0)

Autonomous Developer Runtime & Commercial SDK Platform

DK Agent OS transforms high-level product goals into verified code, test suites, and pull requests with built-in live preview workspaces, cryptographic artifact delivery, and zero-bypass human approval gates.

🚀 Quickstart: CLI (dk-agent)

Installation (Python 3.10+)

pip install dk-agent

Basic Usage

# 1. Build an application from a pure natural language goal
dk-agent build "Tạo hệ thống quản lý học sinh và thống kê điểm"

# 2. Check the real-time status and logs
dk-agent status <job_id>
dk-agent logs <job_id>

# 3. View the artifact manifest with SHA-256 integrity
dk-agent artifact <job_id>

# 4. Export the verified clean ZIP archive
dk-agent export <job_id> -o student_manager.zip

# 5. Approve the candidate code mutation (Human-in-the-Loop)
dk-agent approve <job_id> --approver "lead_architect"

# 6. Open a Pull Request with full provenance evidence
dk-agent pr <job_id> --target-branch main

Environment Variables

Configure your credentials once:

export DK_AGENT_API_KEY="dk_sec_your_secret_api_key"
export DK_AGENT_TENANT_ID="your_company_tenant"
export DK_AGENT_BASE_URL="https://dkchat.xyz"

📦 Quickstart: TypeScript SDK (@dk-agent/sdk)

Installation (Node.js 18+)

npm install @dk-agent/sdk

Programmatic Usage

import { DKAgentSDK } from '@dk-agent/sdk';

const sdk = new DKAgentSDK({
  baseUrl: 'https://dkchat.xyz',
  apiKey: process.env.DK_AGENT_API_KEY,
  tenantId: 'enterprise_corp'
});

// 1. Trigger autonomous build
const run = await sdk.build('Tạo microservice báo cáo tài chính');
console.log(`Job created: ${run.jobId}`);

// 2. Access Candidate & Artifact
const candidate = await run.getCandidate();
console.log(`Candidate Branch: ${candidate.candidateBranch}`);

// 3. Human Approval Gate
await candidate.approve('chief_technology_officer');

// 4. Create Pull Request
const pr = await candidate.createPR('main', 'feat: financial reporting service');
console.log(`Pull Request URL: ${pr.pr_url}`);

🐍 Quickstart: Python SDK

from agent_os.sdk import DKAgentClient

client = DKAgentClient(
    api_key="dk_sec_your_secret_api_key",
    tenant_id="enterprise_corp",
    base_url="https://dkchat.xyz"
)

# 1. Trigger build
run = client.build(goal="Tạo payment gateway Stripe webhook")

# 2. Inspect candidate & approve
candidate = run.candidate
candidate.approve(approver_id="lead_developer")

# 3. Export verified ZIP archive
zip_bytes = candidate.export_zip(output_path="stripe_gateway.zip")

# 4. Create Git PR
pr_result = candidate.create_pr(target_branch="main", title="feat: stripe webhook integration")
print(f"PR opened: {pr_result['pr_url']}")

🛡️ Architecture & Security Model

                    DK AGENT OS CORE
                       🔒 FROZEN
                           │
         ┌─────────────────┴─────────────────┐
         │                                   │
  [🌐 Web Chat UI]     [💻 dk-agent CLI]     [📦 @dk-agent/sdk]
(Realtime SSE Drawer)   (POSIX Subcommands)   (Python & TS SDKs)
         │                     │                     │
         └─────────────────────┼─────────────────────┘
                               ▼
                        AGENT RUN GATEWAY
                    (POST /api/agent/runs)
                               │
                               ▼
                           CANDIDATE
                   ┌───────────┴───────────┐
                   ▼                       ▼
            LIVE PREVIEW                ARTIFACT
                   │                       │
                   └───────────┬───────────┘
                               ▼
                        HUMAN APPROVAL
                               │
                               ▼
                        GIT PULL REQUEST
                               │
                               ▼
                          HUMAN MERGE

• Zero-Bypass Human Gate: DK Agent OS creates candidates and PRs, but has 0 merge authority. Merging to production branches requires human developer approval.
• Strict Tenant Boundary: Cryptographic multi-tenant isolation ensures tenants cannot view, execute, or inspect each other's workspaces or runs.
• Secret Leakage Protection: Master API keys and credentials are never emitted into generated code, candidate branches, artifacts, or PR bodies.

📄 Documentation

For detailed guides, please refer to docs/GETTING_STARTED.md.