divi 0.0.1b0__tar.gz

divi-0.0.1b0/.dockerignore

@@ -0,0 +1 @@
+node_modules

divi-0.0.1b0/.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: uv # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"

divi-0.0.1b0/.gitignore

@@ -0,0 +1,52 @@
+.vscode/
+.idea/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+.next/
+dist/
+out/
+tmp/
+build/
+bin/
+
+# Environments
+.venv/
+.env
+
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# Dependencies
+node_modules
+.pnp
+.pnp.js
+
+# Local env files
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Testing
+coverage
+
+# Turbo
+.turbo
+
+# Vercel
+.vercel
+
+# Debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pytest_cache/
+
+# Misc
+.DS_Store
+*.pem

divi-0.0.1b0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kaikai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

divi-0.0.1b0/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.4
+Name: divi
+Version: 0.0.1b0
+Summary: The Agent Platform for Observability & Evaluation
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: grpcio>=1.71.0
+Requires-Dist: openai>=1.65.2
+Requires-Dist: protobuf<6.0.dev0,>=5.26.1
+Requires-Dist: pyjwt>=2.10.1
+Requires-Dist: requests>=2.32.3
+Description-Content-Type: text/markdown
+
+# Divine Agent
+
+Agent Platform for Observability • Evaluation • Playground
+
+> The project is still in the development stage. 😇

divi-0.0.1b0/README.md

@@ -0,0 +1,14 @@
+# divine-agent
+
+**Agent Platform for Observability**
+
+## TODO
+
+- [ ] Web
+- [ ] Docs
+
+## Architecture
+
+![architecture](./docs/images/architecture.svg)
+
+![storage](./docs/images/storage.svg)

divi-0.0.1b0/apps/README.md

@@ -0,0 +1,15 @@
+# Apps
+
+> A series of web applications.
+
+## Table of Contents
+
+| Name | Description | Port |
+| --- | --- | --- |
+| graphql | A GraphQL server | 4000 |
+| web | A Next.js web server | 4001 |
+| docs | A documentation server | 4002 |
+
+## Rules
+
+1. [Split project files by feature or route](https://nextjs.org/docs/app/getting-started/project-structure#split-project-files-by-feature-or-route)

divi-0.0.1b0/apps/docs/README.md

@@ -0,0 +1,32 @@
+# Mintlify Starter Kit
+
+Click on `Use this template` to copy the Mintlify starter kit. The starter kit contains examples including
+
+- Guide pages
+- Navigation
+- Customizations
+- API Reference pages
+- Use of popular components
+
+### Development
+
+Install the [Mintlify CLI](https://www.npmjs.com/package/mintlify) to preview the documentation changes locally. To install, use the following command
+
+```
+npm i -g mintlify
+```
+
+Run the following command at the root of your documentation (where docs.json is)
+
+```
+mintlify dev
+```
+
+### Publishing Changes
+
+Install our Github App to auto propagate changes from your repo to your deployment. Changes will be deployed to production automatically after pushing to the default branch. Find the link to install on your dashboard. 
+
+#### Troubleshooting
+
+- Mintlify dev isn't running - Run `mintlify install` it'll re-install dependencies.
+- Page loads as a 404 - Make sure you are running in a folder with `docs.json`

divi-0.0.1b0/apps/docs/docs.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://mintlify.com/docs.json",
+  "theme": "maple",
+  "name": "Divine Agent",
+  "colors": {
+    "primary": "#09090b",
+    "light": "#FAFAFA",
+    "dark": "#09090b"
+  },
+  "favicon": "/favicon.ico",
+  "navigation": {
+    "languages": [
+      {
+        "language": "en",
+        "groups": [
+          {
+            "group": "Get Started",
+            "pages": ["en/introduction"]
+          },
+          {
+            "group": "Tutorials",
+            "pages": ["en/tutorials/self-refine"]
+          }
+        ]
+      },
+      {
+        "language": "zh",
+        "groups": [
+          {
+            "group": "快速开始",
+            "pages": ["zh/introduction"]
+          },
+          {
+            "group": "使用案例",
+            "pages": ["zh/tutorials/self-refine"]
+          }
+        ]
+      }
+    ],
+    "global": {
+      "anchors": [
+        {
+          "anchor": "Dashboard",
+          "href": "https://divine-agent.com",
+          "icon": "gauge-high"
+        }
+      ]
+    }
+  },
+  "logo": {
+    "light": "/images/researcher-angel.png",
+    "dark": "/images/scholar-angel.png"
+  },
+  "navbar": {
+    "links": [
+      {
+        "label": "GitHub",
+        "href": "https://github.com/Kaikaikaifang/divine-agent"
+      }
+    ],
+    "primary": {
+      "type": "button",
+      "label": "Divine Agent",
+      "href": "https://divine-agent.com"
+    }
+  },
+  "seo": {
+    "metatags": {
+      "og:image": "https://raw.githubusercontent.com/Kaikaikaifang/divine-agent/refs/heads/main/docs/images/og-image.png?token=GHSAT0AAAAAAC7SUUQIZIJIKDD5UWUKWX2CZ66TXVA"
+    },
+    "indexing": "navigable"
+  },
+  "footer": {
+    "socials": {
+      "github": "https://github.com/Kaikaikaifang/divine-agent"
+    }
+  }
+}

divi-0.0.1b0/apps/docs/en/concepts/score.mdx

@@ -0,0 +1,4 @@
+---
+title: 'Score'
+description: 'Evaluate Scores'
+---

divi-0.0.1b0/apps/docs/en/concepts/session.mdx

@@ -0,0 +1,4 @@
+---
+title: 'Session'
+description: 'Session is a one-time run of your codes'
+---

divi-0.0.1b0/apps/docs/en/development/roadmap.mdx

@@ -0,0 +1,4 @@
+---
+title: 'Roadmap'
+description: 'Development Roadmap for Divine Agent'
+---

divi-0.0.1b0/apps/docs/en/introduction.mdx

@@ -0,0 +1,15 @@
+---
+title: Introduction
+description: "Welcome to the docs of Divine Agent"
+---
+
+<img
+  className="block dark:hidden w-20"
+  src="/images/researcher-angel.png"
+  alt="Hero Light"
+/>
+<img
+  className="hidden dark:block w-20"
+  src="/images/scholar-angel.png"
+  alt="Hero Dark"
+/>

divi-0.0.1b0/apps/docs/en/quickstart/trace.mdx

@@ -0,0 +1,4 @@
+---
+title: 'Trace'
+description: 'Start observe your agents in under 5 minutes'
+---

divi-0.0.1b0/apps/docs/en/tutorials/self-refine.mdx

@@ -0,0 +1,4 @@
+---
+title: 'Self Refine'
+description: 'Self-Refine for single agent'
+---

divi-0.0.1b0/apps/docs/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@app/docs",
+  "private": true,
+  "scripts": {
+    "dev": "mintlify dev --port 4002 --no-open",
+    "lint": "mintlify broken-links"
+  },
+  "devDependencies": {
+    "typescript": "catalog:"
+  }
+}

divi-0.0.1b0/apps/docs/snippets/snippet-intro.mdx

@@ -0,0 +1,4 @@
+One of the core principles of software development is DRY (Don't Repeat
+Yourself). This is a principle that apply to documentation as
+well. If you find yourself repeating the same content in multiple places, you
+should consider creating a custom snippet to keep your content in sync.

divi-0.0.1b0/apps/docs/zh/concepts/score.mdx

@@ -0,0 +1,4 @@
+---
+title: '评分'
+description: '评估评分'
+---

divi-0.0.1b0/apps/docs/zh/concepts/session.mdx

@@ -0,0 +1,4 @@
+---
+title: '会话'
+description: 'Session is a one-time run of your codes'
+---

divi-0.0.1b0/apps/docs/zh/development/roadmap.mdx

@@ -0,0 +1,4 @@
+---
+title: '开发路线图'
+description: '开发路线图'
+---

divi-0.0.1b0/apps/docs/zh/introduction.mdx

@@ -0,0 +1,15 @@
+---
+title: '介绍'
+description: "欢迎使用 Divine Agent"
+---
+
+<img
+  className="block dark:hidden w-20"
+  src="/images/researcher-angel.png"
+  alt="Hero Light"
+/>
+<img
+  className="hidden dark:block w-20"
+  src="/images/scholar-angel.png"
+  alt="Hero Dark"
+/>

divi-0.0.1b0/apps/docs/zh/quickstart/trace.mdx

@@ -0,0 +1,4 @@
+---
+title: '跟踪'
+description: 'Start observe your agents in under 5 minutes'
+---

divi-0.0.1b0/apps/docs/zh/tutorials/self-refine.mdx

@@ -0,0 +1,4 @@
+---
+title: '自我反思'
+description: '单智能体自我反思'
+---

divi-0.0.1b0/apps/graphql/Dockerfile

@@ -0,0 +1,43 @@
+FROM node:23-alpine AS base
+
+FROM base AS builder
+# Check https://github.com/nodejs/docker-node/tree/b4117f9333da4138b03a546ec926ef50a31506c3#nodealpine to understand why libc6-compat might be needed.
+RUN apk update
+RUN apk add --no-cache libc6-compat
+# 启用 corepack 并激活 pnpm
+RUN corepack enable && corepack prepare pnpm@latest --activate
+# Set working directory
+WORKDIR /app
+# 使用 yarn 全局安装 turbo
+RUN yarn global add turbo
+COPY . .
+RUN turbo prune @app/graphql --docker
+
+# Add lockfile and package.json's of isolated subworkspace
+FROM base AS installer
+RUN apk update
+RUN apk add --no-cache libc6-compat
+# 启用 corepack 并激活 pnpm
+RUN corepack enable && corepack prepare pnpm@latest --activate
+WORKDIR /app
+
+# First install dependencies (as they change less often)
+COPY --from=builder /app/out/json/ .
+COPY --from=builder /app/out/pnpm-lock.yaml .
+RUN pnpm install
+
+# Build the project and its dependencies
+COPY --from=builder /app/out/full/ .
+RUN pnpm turbo build
+
+FROM base AS runner
+WORKDIR /app
+
+# Don't run production as root
+RUN addgroup --system --gid 1001 divi
+RUN adduser --system --uid 1001 divi
+USER divi
+COPY --from=installer /app .
+
+EXPOSE 4000
+CMD ["node", "apps/graphql/dist/index.js"]

divi-0.0.1b0/apps/graphql/README.md

@@ -0,0 +1,3 @@
+# Catstronauts - server
+
+The starting point of the `server` code for Odyssey Lift-off I course.

divi-0.0.1b0/apps/graphql/codegen.ts

@@ -0,0 +1,19 @@
+import type { CodegenConfig } from '@graphql-codegen/cli';
+
+const config: CodegenConfig = {
+  schema: './src/schema.graphql',
+  generates: {
+    './src/types/types.d.ts': {
+      plugins: ['typescript', 'typescript-resolvers'],
+      config: {
+        contextType: './context#DataSourceContext',
+        mappers: {
+          User: './user#UserModel',
+          APIKey: './api-key#APIKeyModel',
+        },
+      },
+    },
+  },
+};
+
+export default config;

divi-0.0.1b0/apps/graphql/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@app/graphql",
+  "private": true,
+  "main": "index.ts",
+  "scripts": {
+    "dev": "ts-node-dev --respawn ./src/index.ts",
+    "build": "tsc",
+    "start": "npm run build && nodemon ./dist/index.js",
+    "prebuild": "graphql-codegen",
+    "postbuild": "cp src/schema.graphql dist/"
+  },
+  "dependencies": {
+    "@apollo/datasource-rest": "^6.4.1",
+    "@apollo/server": "^4.12.0",
+    "@apollo/utils.keyvaluecache": "^3.1.0",
+    "graphql": "^16.11.0",
+    "graphql-tag": "^2.12.6"
+  },
+  "devDependencies": {
+    "@graphql-codegen/cli": "^4.0.1",
+    "@graphql-codegen/typescript": "^4.1.6",
+    "@graphql-codegen/typescript-resolvers": "^4.5.0",
+    "@workspace/typescript-config": "workspace:*",
+    "nodemon": "^3.1.10",
+    "ts-node-dev": "^2.0.0",
+    "typescript": "catalog:"
+  }
+}

divi-0.0.1b0/apps/graphql/src/datasources/auth-api.ts

@@ -0,0 +1,76 @@
+import type { FetchResponse } from '@/types/response';
+import type { ApiKey, User } from '@/types/types';
+import { type AugmentedRequest, RESTDataSource } from '@apollo/datasource-rest';
+import type { KeyValueCache } from '@apollo/utils.keyvaluecache';
+
+export class AuthAPI extends RESTDataSource {
+  override baseURL = process.env.AUTH_SERVICE_URL ?? 'http://localhost:3000/';
+  private token: string;
+
+  constructor(options: { token: string; cache: KeyValueCache }) {
+    super(options);
+    this.token = options.token;
+  }
+
+  override willSendRequest(_path: string, request: AugmentedRequest) {
+    request.headers.authorization = this.token;
+  }
+
+  async createUser(email: string, password: string, username: string) {
+    return await this.post<FetchResponse<User>>('/api/user/', {
+      body: { email, password, username },
+    });
+  }
+
+  async getCurrentUser() {
+    return await this.get<FetchResponse<User>>('/api/user/');
+  }
+
+  async getUser(userId: string) {
+    return await this.get<FetchResponse<User>>(`/api/user/${userId}`);
+  }
+
+  async updateUser(userId: string, name: string | undefined) {
+    return await this.patch<FetchResponse<User>>(`/api/user/${userId}`, {
+      body: { name },
+    });
+  }
+
+  async deleteUser(userId: string, password: string) {
+    return await this.delete<FetchResponse<null>>(`/api/user/${userId}`, {
+      body: { password },
+    });
+  }
+
+  async getAPIKeys() {
+    return await this.get<FetchResponse<ApiKey[]>>('/api/api_key/');
+  }
+
+  async createAPIKey(name: string) {
+    return await this.post<FetchResponse<ApiKey>>('/api/api_key/', {
+      body: { name },
+    });
+  }
+
+  async updateAPIKey(apiKeyId: string, name: string | undefined) {
+    return await this.patch<FetchResponse<ApiKey>>(`/api/api_key/${apiKeyId}`, {
+      body: { name },
+    });
+  }
+
+  async revokeAPIKey(apiKeyId: string) {
+    return await this.delete<FetchResponse<null>>(`/api/api_key/${apiKeyId}`);
+  }
+
+  async login(identity: string, password: string) {
+    return await this.post<FetchResponse<string>>('/api/auth/login', {
+      body: { identity, password },
+    });
+  }
+
+  async loginWithAPIKey(apiKey: string) {
+    return await this.post<FetchResponse<string>>('/api/auth/api_key', {
+      body: { api_key: apiKey },
+    });
+  }
+}

divi-0.0.1b0/apps/graphql/src/datasources/datapark-api.ts

@@ -0,0 +1,62 @@
+import type { FetchResponse } from '@/types/response';
+import type { ChatInput, Score, Span, Trace, UsageResult } from '@/types/types';
+import { type AugmentedRequest, RESTDataSource } from '@apollo/datasource-rest';
+import type { KeyValueCache } from '@apollo/utils.keyvaluecache';
+
+export class DataParkAPI extends RESTDataSource {
+  override baseURL =
+    process.env.DATAPARK_SERVICE_URL ?? 'http://localhost:3001/';
+  private token: string;
+
+  constructor(options: { token: string; cache: KeyValueCache }) {
+    super(options);
+    this.token = options.token;
+  }
+
+  override willSendRequest(_path: string, request: AugmentedRequest) {
+    request.headers.authorization = this.token;
+  }
+
+  async getTraces(sessionId: string) {
+    return await this.get<FetchResponse<Trace[]>>(
+      `/api/session/${sessionId}/traces`
+    );
+  }
+
+  async getAllTraces() {
+    return await this.get<FetchResponse<Trace[]>>('/api/trace/');
+  }
+
+  async getSpans(traceId: string) {
+    return await this.get<FetchResponse<Span[]>>(`/api/trace/${traceId}/spans`);
+  }
+
+  async getScores(traceId: string) {
+    return await this.get<FetchResponse<Score[]>>(
+      `/api/trace/${traceId}/scores`
+    );
+  }
+
+  async getChatInput(spanId: string) {
+    return await this.get<FetchResponse<ChatInput>>(
+      `/api/v1/chat/completions/${spanId}/input`
+    );
+  }
+
+  async getCompletionUsage(
+    startTime: number,
+    endTime: number | undefined,
+    groupBy: string | undefined
+  ) {
+    return await this.get<FetchResponse<UsageResult[]>>(
+      '/api/usage/completions',
+      {
+        params: {
+          start_time: startTime.toString(),
+          end_time: endTime?.toString(),
+          group_by: groupBy,
+        },
+      }
+    );
+  }
+}

divi-0.0.1b0/apps/graphql/src/index.ts

@@ -0,0 +1,34 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { ApolloServer } from '@apollo/server';
+import { startStandaloneServer } from '@apollo/server/standalone';
+import gql from 'graphql-tag';
+import { AuthAPI } from './datasources/auth-api';
+import { DataParkAPI } from './datasources/datapark-api';
+import { resolvers } from './resolvers';
+
+const typeDefs = gql(
+  readFileSync(join(__dirname, './schema.graphql'), { encoding: 'utf-8' })
+);
+
+async function startApolloServer() {
+  const server = new ApolloServer({ typeDefs, resolvers });
+  const { url } = await startStandaloneServer(server, {
+    context: ({ req }) => {
+      const token = req.headers.authorization || '';
+      const { cache } = server;
+      return Promise.resolve({
+        dataSources: {
+          authAPI: new AuthAPI({ token, cache }),
+          dataparkAPI: new DataParkAPI({ token, cache }),
+        },
+      });
+    },
+  });
+  console.info(`
+    🚀  Server is running!
+    📭  Query at ${url}
+  `);
+}
+
+startApolloServer();