@douglas-agent/sandbank-db9 0.2.1

package/dist/adapter.d.ts

@@ -0,0 +1,25 @@
+import type { ServiceConfig, ServiceInfo, SkillDefinition } from '@douglas-agent/sandbank-core';
+import { Db9Client, type Db9ClientConfig } from './client.js';
+export interface Db9AdapterConfig extends Db9ClientConfig {
+    /** 是否自动注入 db9 官方 skill。默认 true */
+    injectSkill?: boolean;
+    /** 自定义 skill 内容（覆盖默认获取） */
+    skillContent?: string;
+}
+export declare class Db9ServiceAdapter {
+    readonly name = "db9";
+    readonly client: Db9Client;
+    private readonly config;
+    constructor(config: Db9AdapterConfig);
+    createService(config: ServiceConfig): Promise<ServiceInfo>;
+    getService(id: string): Promise<ServiceInfo>;
+    listServices(): Promise<ServiceInfo[]>;
+    destroyService(id: string): Promise<void>;
+    /** 创建数据库分支 */
+    branchService(serviceId: string, name: string): Promise<ServiceInfo>;
+    /** 删除分支 */
+    deleteBranch(branchId: string): Promise<void>;
+    /** 获取 db9 官方 skill（带 24h 内存缓存） */
+    getSkill(): Promise<SkillDefinition>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAC/F,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAI7D,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,kCAAkC;IAClC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AA2BD,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,IAAI,SAAQ;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,gBAAgB;IAK9B,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;IAK1D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAK5C,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAKtC,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C,cAAc;IACR,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAK1E,WAAW;IACL,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,kCAAkC;IAC5B,QAAQ,IAAI,OAAO,CAAC,eAAe,CAAC;CAO3C"}

package/dist/adapter.js

@@ -0,0 +1,68 @@
+import { Db9Client } from './client.js';
+import { fetchDb9Skill, db9SkillDefinition } from './skill.js';
+function mapDbToServiceInfo(db) {
+    return {
+        id: db.id,
+        type: 'postgres',
+        name: db.name,
+        state: db.state === 'ready' ? 'ready'
+            : db.state === 'creating' ? 'creating'
+                : db.state === 'terminated' || db.state === 'deleted' ? 'terminated'
+                    : 'error',
+        credentials: {
+            url: db.connection_string,
+            env: {
+                DATABASE_URL: db.connection_string,
+                DB9_DATABASE_ID: db.id,
+                DB9_DATABASE_NAME: db.name,
+                PGHOST: db.host,
+                PGPORT: String(db.port),
+                PGUSER: db.username,
+                PGPASSWORD: db.password,
+                PGDATABASE: db.database,
+            },
+        },
+    };
+}
+export class Db9ServiceAdapter {
+    name = 'db9';
+    client;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.client = new Db9Client(config);
+    }
+    async createService(config) {
+        const db = await this.client.createDatabase(config.name);
+        return mapDbToServiceInfo(db);
+    }
+    async getService(id) {
+        const db = await this.client.getDatabase(id);
+        return mapDbToServiceInfo(db);
+    }
+    async listServices() {
+        const dbs = await this.client.listDatabases();
+        return dbs.map(mapDbToServiceInfo);
+    }
+    async destroyService(id) {
+        await this.client.deleteDatabase(id);
+    }
+    // --- db9 特有能力 ---
+    /** 创建数据库分支 */
+    async branchService(serviceId, name) {
+        const db = await this.client.createBranch(serviceId, name);
+        return mapDbToServiceInfo(db);
+    }
+    /** 删除分支 */
+    async deleteBranch(branchId) {
+        await this.client.deleteBranch(branchId);
+    }
+    /** 获取 db9 官方 skill（带 24h 内存缓存） */
+    async getSkill() {
+        if (this.config.skillContent) {
+            return db9SkillDefinition(this.config.skillContent);
+        }
+        const content = await fetchDb9Skill();
+        return db9SkillDefinition(content);
+    }
+}

package/dist/brain-skill.d.ts

@@ -0,0 +1,4 @@
+import type { SkillDefinition } from '@douglas-agent/sandbank-core';
+export declare const BRAIN_SKILL = "# brain \u2014 \u5171\u4EAB\u8BB0\u5FC6\u7CFB\u7EDF\n\n\u4F60\u6B63\u5728\u4E00\u4E2A\u591A Agent \u534F\u4F5C\u73AF\u5883\u4E2D\u5DE5\u4F5C\u3002\u4F60\u6709\u4E00\u4E2A\u5171\u4EAB\u6570\u636E\u5E93\u7528\u4E8E\u8BB0\u5FC6\u548C\u4EFB\u52A1\u534F\u8C03\u3002\n\n## \u73AF\u5883\u53D8\u91CF\n- $DATABASE_URL \u2014 PostgreSQL \u8FDE\u63A5\u4E32\n\n## \u5199\u5165\u8BB0\u5FC6\n\u5728\u53D1\u73B0\u91CD\u8981\u4FE1\u606F\u65F6\uFF0C\u5199\u5165 memory \u8868\uFF1A\n```sql\nINSERT INTO memory (agent, scope, kind, content)\nVALUES ('\u4F60\u7684\u89D2\u8272', 'task:\u5F53\u524D\u4EFB\u52A1ID', 'fact|decision|question|blocker', '\u5185\u5BB9');\n```\n\n## \u67E5\u8BE2\u8BB0\u5FC6\n\u5F00\u59CB\u5DE5\u4F5C\u524D\uFF0C\u5148\u67E5\u770B\u5176\u4ED6 Agent \u7684\u53D1\u73B0\uFF1A\n```sql\nSELECT agent, kind, content FROM memory\nWHERE scope = 'task:\u5F53\u524D\u4EFB\u52A1ID' AND superseded_by IS NULL\nORDER BY created_at;\n```\n\n## \u8BED\u4E49\u641C\u7D22\u8BB0\u5FC6\n```sql\nSELECT content, agent, kind FROM memory\nWHERE superseded_by IS NULL\nORDER BY embedding <=> $query_embedding\nLIMIT 10;\n```\n\n## \u8BA4\u9886\u4EFB\u52A1\n```sql\nUPDATE tasks SET status = 'claimed', claimed_by = '\u4F60\u7684\u89D2\u8272', claimed_at = now()\nWHERE id = (\n  SELECT id FROM tasks\n  WHERE status = 'pending'\n    AND NOT EXISTS (\n      SELECT 1 FROM unnest(depends_on) dep JOIN tasks t ON t.id = dep WHERE t.status != 'done'\n    )\n  ORDER BY created_at FOR UPDATE SKIP LOCKED LIMIT 1\n) RETURNING *;\n```\n\n## \u5B8C\u6210\u4EFB\u52A1\n```sql\nUPDATE tasks SET status = 'done', result = '{\"summary\":\"...\"}' WHERE id = \u5F53\u524D\u4EFB\u52A1ID;\n```\n\n## \u6CE8\u518C\u4EA7\u51FA\u7269\n```sql\nINSERT INTO artifacts (task_id, agent, kind, path, content)\nVALUES (\u5F53\u524D\u4EFB\u52A1ID, '\u4F60\u7684\u89D2\u8272', 'code|analysis|config', '/path/to/file', '\u5185\u5BB9\u6458\u8981');\n```\n";
+export declare function brainSkillDefinition(): SkillDefinition;
+//# sourceMappingURL=brain-skill.d.ts.map

package/dist/brain-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-skill.d.ts","sourceRoot":"","sources":["../src/brain-skill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAEnE,eAAO,MAAM,WAAW,43DAqDvB,CAAA;AAED,wBAAgB,oBAAoB,IAAI,eAAe,CAEtD"}

package/dist/brain-skill.js

@@ -0,0 +1,57 @@
+export const BRAIN_SKILL = `# brain — 共享记忆系统
+
+你正在一个多 Agent 协作环境中工作。你有一个共享数据库用于记忆和任务协调。
+
+## 环境变量
+- \$DATABASE_URL — PostgreSQL 连接串
+
+## 写入记忆
+在发现重要信息时，写入 memory 表：
+\`\`\`sql
+INSERT INTO memory (agent, scope, kind, content)
+VALUES ('你的角色', 'task:当前任务ID', 'fact|decision|question|blocker', '内容');
+\`\`\`
+
+## 查询记忆
+开始工作前，先查看其他 Agent 的发现：
+\`\`\`sql
+SELECT agent, kind, content FROM memory
+WHERE scope = 'task:当前任务ID' AND superseded_by IS NULL
+ORDER BY created_at;
+\`\`\`
+
+## 语义搜索记忆
+\`\`\`sql
+SELECT content, agent, kind FROM memory
+WHERE superseded_by IS NULL
+ORDER BY embedding <=> $query_embedding
+LIMIT 10;
+\`\`\`
+
+## 认领任务
+\`\`\`sql
+UPDATE tasks SET status = 'claimed', claimed_by = '你的角色', claimed_at = now()
+WHERE id = (
+  SELECT id FROM tasks
+  WHERE status = 'pending'
+    AND NOT EXISTS (
+      SELECT 1 FROM unnest(depends_on) dep JOIN tasks t ON t.id = dep WHERE t.status != 'done'
+    )
+  ORDER BY created_at FOR UPDATE SKIP LOCKED LIMIT 1
+) RETURNING *;
+\`\`\`
+
+## 完成任务
+\`\`\`sql
+UPDATE tasks SET status = 'done', result = '{"summary":"..."}' WHERE id = 当前任务ID;
+\`\`\`
+
+## 注册产出物
+\`\`\`sql
+INSERT INTO artifacts (task_id, agent, kind, path, content)
+VALUES (当前任务ID, '你的角色', 'code|analysis|config', '/path/to/file', '内容摘要');
+\`\`\`
+`;
+export function brainSkillDefinition() {
+    return { name: 'brain', content: BRAIN_SKILL };
+}

package/dist/brain.d.ts

@@ -0,0 +1,5 @@
+import type { Db9Client } from './client.js';
+export declare const BRAIN_SCHEMA = "\n-- \u5171\u4EAB\u8BB0\u5FC6\nCREATE TABLE IF NOT EXISTS memory (\n  id serial PRIMARY KEY,\n  agent text NOT NULL,\n  scope text NOT NULL DEFAULT 'global',\n  kind text NOT NULL CHECK (kind IN ('fact','decision','question','blocker')),\n  content text NOT NULL,\n  embedding vector(1536),\n  created_at timestamptz DEFAULT now(),\n  superseded_by int REFERENCES memory(id)\n);\nCREATE INDEX IF NOT EXISTS idx_memory_scope ON memory (scope, kind);\nCREATE INDEX IF NOT EXISTS idx_memory_embedding ON memory USING hnsw (embedding vector_cosine_ops);\n\n-- \u4EFB\u52A1\u534F\u8C03\nCREATE TABLE IF NOT EXISTS tasks (\n  id serial PRIMARY KEY,\n  title text NOT NULL,\n  status text DEFAULT 'pending' CHECK (status IN ('pending','claimed','done','failed')),\n  claimed_by text,\n  claimed_at timestamptz,\n  depends_on int[] DEFAULT '{}',\n  result jsonb,\n  created_at timestamptz DEFAULT now()\n);\nCREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks (status);\n\n-- \u4EA7\u51FA\u7269\u6CE8\u518C\nCREATE TABLE IF NOT EXISTS artifacts (\n  id serial PRIMARY KEY,\n  task_id int REFERENCES tasks(id),\n  agent text NOT NULL,\n  kind text NOT NULL,\n  path text,\n  content text,\n  metadata jsonb,\n  created_at timestamptz DEFAULT now()\n);\n";
+/** 初始化 brain schema（含 pgvector 扩展） */
+export declare function initBrainSchema(client: Db9Client, dbId: string): Promise<void>;
+//# sourceMappingURL=brain.d.ts.map

package/dist/brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../src/brain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,eAAO,MAAM,YAAY,kuCAuCxB,CAAA;AAED,sCAAsC;AACtC,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpF"}

package/dist/brain.js

@@ -0,0 +1,45 @@
+export const BRAIN_SCHEMA = `
+-- 共享记忆
+CREATE TABLE IF NOT EXISTS memory (
+  id serial PRIMARY KEY,
+  agent text NOT NULL,
+  scope text NOT NULL DEFAULT 'global',
+  kind text NOT NULL CHECK (kind IN ('fact','decision','question','blocker')),
+  content text NOT NULL,
+  embedding vector(1536),
+  created_at timestamptz DEFAULT now(),
+  superseded_by int REFERENCES memory(id)
+);
+CREATE INDEX IF NOT EXISTS idx_memory_scope ON memory (scope, kind);
+CREATE INDEX IF NOT EXISTS idx_memory_embedding ON memory USING hnsw (embedding vector_cosine_ops);
+
+-- 任务协调
+CREATE TABLE IF NOT EXISTS tasks (
+  id serial PRIMARY KEY,
+  title text NOT NULL,
+  status text DEFAULT 'pending' CHECK (status IN ('pending','claimed','done','failed')),
+  claimed_by text,
+  claimed_at timestamptz,
+  depends_on int[] DEFAULT '{}',
+  result jsonb,
+  created_at timestamptz DEFAULT now()
+);
+CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks (status);
+
+-- 产出物注册
+CREATE TABLE IF NOT EXISTS artifacts (
+  id serial PRIMARY KEY,
+  task_id int REFERENCES tasks(id),
+  agent text NOT NULL,
+  kind text NOT NULL,
+  path text,
+  content text,
+  metadata jsonb,
+  created_at timestamptz DEFAULT now()
+);
+`;
+/** 初始化 brain schema（含 pgvector 扩展） */
+export async function initBrainSchema(client, dbId) {
+    await client.executeSQL(dbId, 'CREATE EXTENSION IF NOT EXISTS vector');
+    await client.executeSQL(dbId, BRAIN_SCHEMA);
+}

package/dist/client.d.ts

@@ -0,0 +1,28 @@
+import type { Db9Database, Db9SqlResult } from './types.js';
+export interface Db9ClientConfig {
+    /** db9 API Token */
+    token: string;
+    /** API Base URL，默认 https://db9.ai/api */
+    baseUrl?: string;
+}
+export declare class Db9Client {
+    private readonly baseUrl;
+    private readonly token;
+    constructor(config: Db9ClientConfig);
+    /** 创建数据库 */
+    createDatabase(name: string): Promise<Db9Database>;
+    /** 获取数据库详情 */
+    getDatabase(id: string): Promise<Db9Database>;
+    /** 列出所有数据库 */
+    listDatabases(): Promise<Db9Database[]>;
+    /** 删除数据库（幂等） */
+    deleteDatabase(id: string): Promise<void>;
+    /** 执行 SQL */
+    executeSQL(dbId: string, query: string): Promise<Db9SqlResult>;
+    /** 创建分支 */
+    createBranch(dbId: string, name: string): Promise<Db9Database>;
+    /** 删除分支（删除分支数据库） */
+    deleteBranch(branchDbId: string): Promise<void>;
+    private request;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE3D,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;gBAElB,MAAM,EAAE,eAAe;IAKnC,YAAY;IACN,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIxD,cAAc;IACR,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAInD,cAAc;IACR,aAAa,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI7C,gBAAgB;IACV,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,aAAa;IACP,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAQpE,WAAW;IACL,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQpE,oBAAoB;IACd,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAIvC,OAAO;CAiCtB"}

package/dist/client.js

@@ -0,0 +1,67 @@
+export class Db9Client {
+    baseUrl;
+    token;
+    constructor(config) {
+        this.baseUrl = (config.baseUrl ?? 'https://db9.ai/api').replace(/\/$/, '');
+        this.token = config.token;
+    }
+    /** 创建数据库 */
+    async createDatabase(name) {
+        return this.request('POST', '/customer/databases', { name });
+    }
+    /** 获取数据库详情 */
+    async getDatabase(id) {
+        return this.request('GET', `/customer/databases/${encodeURIComponent(id)}`);
+    }
+    /** 列出所有数据库 */
+    async listDatabases() {
+        return this.request('GET', '/customer/databases');
+    }
+    /** 删除数据库（幂等） */
+    async deleteDatabase(id) {
+        await this.request('DELETE', `/customer/databases/${encodeURIComponent(id)}`);
+    }
+    /** 执行 SQL */
+    async executeSQL(dbId, query) {
+        return this.request('POST', `/customer/databases/${encodeURIComponent(dbId)}/sql`, { query });
+    }
+    /** 创建分支 */
+    async createBranch(dbId, name) {
+        return this.request('POST', `/customer/databases/${encodeURIComponent(dbId)}/branch`, { name });
+    }
+    /** 删除分支（删除分支数据库） */
+    async deleteBranch(branchDbId) {
+        await this.deleteDatabase(branchDbId);
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Authorization': `Bearer ${this.token}`,
+            'Accept': 'application/json',
+        };
+        const init = { method, headers };
+        if (body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+            init.body = JSON.stringify(body);
+        }
+        const resp = await fetch(url, init);
+        if (!resp.ok) {
+            let message = `db9 API error: ${resp.status} ${resp.statusText}`;
+            try {
+                const err = await resp.json();
+                if (err.error || err.message) {
+                    message = `db9 API error: ${err.error ?? err.message}`;
+                }
+            }
+            catch {
+                // ignore parse errors
+            }
+            throw new Error(message);
+        }
+        // DELETE 等可能无 body
+        const text = await resp.text();
+        if (!text)
+            return undefined;
+        return JSON.parse(text);
+    }
+}

package/dist/convenience.d.ts

@@ -0,0 +1,19 @@
+import type { ServiceInfo, SkillDefinition } from '@douglas-agent/sandbank-core';
+import { Db9ServiceAdapter, type Db9AdapterConfig } from './adapter.js';
+/** 一键创建数据库 + 获取 skill */
+export declare function createDb9Service(config: Db9AdapterConfig & {
+    name: string;
+}): Promise<{
+    service: ServiceInfo;
+    skill: SkillDefinition;
+    adapter: Db9ServiceAdapter;
+}>;
+/** 一键创建带 brain schema 的多 Agent 数据库 */
+export declare function createDb9Brain(config: Db9AdapterConfig & {
+    name: string;
+}): Promise<{
+    service: ServiceInfo;
+    skills: SkillDefinition[];
+    adapter: Db9ServiceAdapter;
+}>;
+//# sourceMappingURL=convenience.d.ts.map

package/dist/convenience.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convenience.d.ts","sourceRoot":"","sources":["../src/convenience.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAChF,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAIvE,yBAAyB;AACzB,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAOvF;AAED,sCAAsC;AACtC,wBAAsB,cAAc,CAClC,MAAM,EAAE,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC;IACT,OAAO,EAAE,WAAW,CAAA;IACpB,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,OAAO,EAAE,iBAAiB,CAAA;CAC3B,CAAC,CAeD"}

package/dist/convenience.js

@@ -0,0 +1,29 @@
+import { Db9ServiceAdapter } from './adapter.js';
+import { initBrainSchema } from './brain.js';
+import { brainSkillDefinition } from './brain-skill.js';
+/** 一键创建数据库 + 获取 skill */
+export async function createDb9Service(config) {
+    const adapter = new Db9ServiceAdapter(config);
+    const [service, skill] = await Promise.all([
+        adapter.createService({ type: 'postgres', name: config.name }),
+        adapter.getSkill(),
+    ]);
+    return { service, skill, adapter };
+}
+/** 一键创建带 brain schema 的多 Agent 数据库 */
+export async function createDb9Brain(config) {
+    const { service, skill, adapter } = await createDb9Service(config);
+    if (service.state !== 'ready') {
+        await adapter.destroyService(service.id).catch(() => { });
+        throw new Error(`Database '${service.id}' is not ready (state: ${service.state}), cannot initialize brain schema`);
+    }
+    await initBrainSchema(adapter.client, service.id).catch(async (err) => {
+        await adapter.destroyService(service.id).catch(() => { });
+        throw err;
+    });
+    return {
+        service,
+        skills: [skill, brainSkillDefinition()],
+        adapter,
+    };
+}

package/dist/db9-observer.d.ts

@@ -0,0 +1,9 @@
+import type { SandboxObserver } from '@douglas-agent/sandbank-core';
+import type { Db9Client } from './client.js';
+export declare const EVENTS_SCHEMA = "\nCREATE TABLE IF NOT EXISTS sandbox_events (\n  id serial PRIMARY KEY,\n  type text NOT NULL,\n  sandbox_id text NOT NULL,\n  task_id text,\n  data jsonb NOT NULL DEFAULT '{}',\n  created_at timestamptz DEFAULT now()\n);\nCREATE INDEX IF NOT EXISTS idx_sandbox_events_sandbox ON sandbox_events (sandbox_id);\nCREATE INDEX IF NOT EXISTS idx_sandbox_events_type ON sandbox_events (type);\n";
+/**
+ * 创建 DB9 观察者，将沙箱事件写入 sandbox_events 表。
+ * 首次调用时自动初始化表结构。
+ */
+export declare function createDb9Observer(client: Db9Client, dbId: string): SandboxObserver;
+//# sourceMappingURL=db9-observer.d.ts.map

package/dist/db9-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db9-observer.d.ts","sourceRoot":"","sources":["../src/db9-observer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,8BAA8B,CAAA;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,eAAO,MAAM,aAAa,yYAWzB,CAAA;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAkBlF"}

package/dist/db9-observer.js

@@ -0,0 +1,36 @@
+export const EVENTS_SCHEMA = `
+CREATE TABLE IF NOT EXISTS sandbox_events (
+  id serial PRIMARY KEY,
+  type text NOT NULL,
+  sandbox_id text NOT NULL,
+  task_id text,
+  data jsonb NOT NULL DEFAULT '{}',
+  created_at timestamptz DEFAULT now()
+);
+CREATE INDEX IF NOT EXISTS idx_sandbox_events_sandbox ON sandbox_events (sandbox_id);
+CREATE INDEX IF NOT EXISTS idx_sandbox_events_type ON sandbox_events (type);
+`;
+function escapeSql(str) {
+    return str.replace(/'/g, "''");
+}
+/**
+ * 创建 DB9 观察者，将沙箱事件写入 sandbox_events 表。
+ * 首次调用时自动初始化表结构。
+ */
+export function createDb9Observer(client, dbId) {
+    let schemaReady = null;
+    function ensureSchema() {
+        if (!schemaReady) {
+            schemaReady = client.executeSQL(dbId, EVENTS_SCHEMA).then(() => { });
+        }
+        return schemaReady;
+    }
+    return {
+        async onEvent(event) {
+            await ensureSchema();
+            const taskIdVal = event.taskId ? `'${escapeSql(event.taskId)}'` : 'NULL';
+            const sql = `INSERT INTO sandbox_events (type, sandbox_id, task_id, data, created_at) VALUES ('${escapeSql(event.type)}', '${escapeSql(event.sandboxId)}', ${taskIdVal}, '${escapeSql(JSON.stringify(event.data))}'::jsonb, to_timestamp(${event.timestamp / 1000}))`;
+            await client.executeSQL(dbId, sql);
+        },
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { Db9ServiceAdapter } from './adapter.js';
+export type { Db9AdapterConfig } from './adapter.js';
+export { Db9Client } from './client.js';
+export type { Db9ClientConfig } from './client.js';
+export { fetchDb9Skill, db9SkillDefinition, clearSkillCache } from './skill.js';
+export { BRAIN_SCHEMA, initBrainSchema } from './brain.js';
+export { BRAIN_SKILL, brainSkillDefinition } from './brain-skill.js';
+export { createDb9Service, createDb9Brain } from './convenience.js';
+export { EVENTS_SCHEMA, createDb9Observer } from './db9-observer.js';
+export type { Db9Database, Db9SqlResult, Db9ApiError } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAGpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAGlD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAG/E,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAGpE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGnE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAGpE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// Adapter
+export { Db9ServiceAdapter } from './adapter.js';
+// Client
+export { Db9Client } from './client.js';
+// Skill
+export { fetchDb9Skill, db9SkillDefinition, clearSkillCache } from './skill.js';
+// Brain
+export { BRAIN_SCHEMA, initBrainSchema } from './brain.js';
+export { BRAIN_SKILL, brainSkillDefinition } from './brain-skill.js';
+// Convenience
+export { createDb9Service, createDb9Brain } from './convenience.js';
+// Observer
+export { EVENTS_SCHEMA, createDb9Observer } from './db9-observer.js';

package/dist/skill.d.ts

@@ -0,0 +1,8 @@
+import type { SkillDefinition } from '@douglas-agent/sandbank-core';
+/** 获取 db9 官方 skill，带 24h 内存缓存和并发去重 */
+export declare function fetchDb9Skill(): Promise<string>;
+/** 构建注入用的 SkillDefinition */
+export declare function db9SkillDefinition(content: string): SkillDefinition;
+/** 清除 skill 缓存（测试用）。不清空 inflightRequest，让飞行中的请求自然完成。 */
+export declare function clearSkillCache(): void;
+//# sourceMappingURL=skill.d.ts.map

package/dist/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAQnE,sCAAsC;AACtC,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAkBrD;AAED,6BAA6B;AAC7B,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAEnE;AAED,wDAAwD;AACxD,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/skill.js

@@ -0,0 +1,32 @@
+const SKILL_URL = 'https://db9.ai/skill.md';
+const CACHE_TTL = 24 * 60 * 60 * 1000; // 24 hours
+let cachedSkill = null;
+let inflightRequest = null;
+/** 获取 db9 官方 skill，带 24h 内存缓存和并发去重 */
+export async function fetchDb9Skill() {
+    if (cachedSkill && Date.now() - cachedSkill.fetchedAt < CACHE_TTL) {
+        return cachedSkill.content;
+    }
+    if (!inflightRequest) {
+        inflightRequest = (async () => {
+            const resp = await fetch(SKILL_URL);
+            if (!resp.ok) {
+                throw new Error(`Failed to fetch db9 skill: ${resp.status} ${resp.statusText}`);
+            }
+            const content = await resp.text();
+            cachedSkill = { content, fetchedAt: Date.now() };
+            return content;
+        })().finally(() => {
+            inflightRequest = null;
+        });
+    }
+    return inflightRequest;
+}
+/** 构建注入用的 SkillDefinition */
+export function db9SkillDefinition(content) {
+    return { name: 'db9-postgres', content };
+}
+/** 清除 skill 缓存（测试用）。不清空 inflightRequest，让飞行中的请求自然完成。 */
+export function clearSkillCache() {
+    cachedSkill = null;
+}

package/dist/types.d.ts

@@ -0,0 +1,25 @@
+/** db9 API 响应：数据库 */
+export interface Db9Database {
+    id: string;
+    name: string;
+    state: string;
+    host: string;
+    port: number;
+    username: string;
+    password: string;
+    database: string;
+    connection_string: string;
+    created_at: string;
+}
+/** db9 API 响应：SQL 执行结果 */
+export interface Db9SqlResult {
+    columns: string[];
+    rows: unknown[][];
+    row_count: number;
+}
+/** db9 API 响应：错误 */
+export interface Db9ApiError {
+    error: string;
+    message?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,0BAA0B;AAC1B,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,OAAO,EAAE,EAAE,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,oBAAoB;AACpB,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@douglas-agent/sandbank-db9",
+  "version": "0.2.1",
+  "description": "db9.ai service adapter for Sandbank — serverless PostgreSQL for AI agents",
+  "license": "MIT",
+  "type": "module",
+  "homepage": "https://sandbank.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Xeonice/sandbank-douglas-agent.git",
+    "directory": "packages/db9"
+  },
+  "keywords": [
+    "sandbox",
+    "ai-agent",
+    "db9",
+    "postgres",
+    "database",
+    "service"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts"
+  },
+  "dependencies": {
+    "@douglas-agent/sandbank-core": "^0.3.6"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.18"
+  }
+}