14 | {children}
15 |
16 | )
17 | )
18 | ScrollArea.displayName = "ScrollArea"
19 |
20 | export { ScrollArea }
--------------------------------------------------------------------------------
/tsconfig.typecheck.json:
--------------------------------------------------------------------------------
1 | {
2 | "extends": "./tsconfig.json",
3 | "compilerOptions": {
4 | "noEmit": true,
5 | "strict": true,
6 | "noUncheckedIndexedAccess": true,
7 | "noImplicitReturns": true,
8 | "noFallthroughCasesInSwitch": true,
9 | "noImplicitOverride": true,
10 | "exactOptionalPropertyTypes": true,
11 | "skipLibCheck": true
12 | },
13 | "include": ["src/core/**/*", "src/app/**/*"],
14 | "exclude": [
15 | "node_modules",
16 | "dist",
17 | "**/*.d.ts",
18 | "**/__test__/**",
19 | "**/__tests__/**",
20 | "src/app/ui/**/*"
21 | ]
22 | }
23 |
--------------------------------------------------------------------------------
/matrix/.github/workflows/test.yml:
--------------------------------------------------------------------------------
1 | name: test
2 |
3 | on:
4 | push:
5 | branches:
6 | - master
7 | - main
8 | pull_request:
9 |
10 | jobs:
11 | test:
12 | runs-on: ubuntu-latest
13 | steps:
14 | - uses: actions/checkout@v4
15 | - uses: erlef/setup-beam@v1
16 | with:
17 | otp-version: "27.1.2"
18 | gleam-version: "1.11.1"
19 | rebar3-version: "3"
20 | # elixir-version: "1"
21 | - run: gleam deps download
22 | - run: gleam test
23 | - run: gleam format --check src test
24 |
--------------------------------------------------------------------------------
/src/app/ui/src/lib/utils.ts:
--------------------------------------------------------------------------------
1 | import { type ClassValue, clsx } from 'clsx';
2 | import { twMerge } from 'tailwind-merge';
3 |
4 | export function cn(...inputs: ClassValue[]) {
5 | return twMerge(clsx(inputs));
6 | }
7 |
8 | export function formatTimestamp(timestamp: number): string {
9 | return new Date(timestamp).toLocaleTimeString();
10 | }
11 |
12 | export function generateId(): string {
13 | return Math.random().toString(36).substring(2, 15) + Math.random().toString(36).substring(2, 15);
14 | }
15 |
16 | // Re-export chat utilities
17 | export * from './chat-utils';
18 |
--------------------------------------------------------------------------------
/matrix/README.md:
--------------------------------------------------------------------------------
1 | # matrix
2 |
3 | [](https://hex.pm/packages/matrix)
4 | [](https://hexdocs.pm/matrix/)
5 |
6 | ```sh
7 | gleam add matrix@1
8 | ```
9 | ```gleam
10 | import matrix
11 |
12 | pub fn main() -> Nil {
13 | // TODO: An example of the project in use
14 | }
15 | ```
16 |
17 | Further documentation can be found at
19 | {isOpen && (
20 |
25 | );
26 | }
--------------------------------------------------------------------------------
/src/app/ui/src/components/ui/label.tsx:
--------------------------------------------------------------------------------
1 | import * as React from "react"
2 | import * as LabelPrimitive from "@radix-ui/react-label"
3 |
4 | import { cn } from "@/lib/utils"
5 |
6 | const Label = React.forwardRef<
7 | React.ElementRef
21 | {children}
22 |
23 | )}
24 | {children}
27 |
16 |
28 | );
29 | }
--------------------------------------------------------------------------------
/tsup.config.ts:
--------------------------------------------------------------------------------
1 | import { defineConfig } from 'tsup';
2 | export default defineConfig([
3 | {
4 | entry: ['src/core/index.ts'],
5 | format: ['cjs', 'esm'],
6 | outDir: 'dist/src/core',
7 | dts: true,
8 | shims: true,
9 | bundle: true,
10 | noExternal: ['chalk', 'boxen'],
11 | external: ['better-sqlite3', 'pg', 'redis'],
12 | },
13 | {
14 | entry: ['src/app/index.ts'],
15 | format: ['cjs'], // Use only CommonJS for app to avoid dynamic require issues
16 | outDir: 'dist/src/app',
17 | shims: true,
18 | bundle: true,
19 | platform: 'node',
20 | target: 'node18', // Specify Node.js target version
21 | external: [
22 | // Database drivers
23 | 'better-sqlite3',
24 | 'pg',
25 | 'neo4j-driver',
26 | 'ioredis',
27 | // Node.js built-in modules to prevent bundling issues
28 | 'fs',
29 | 'path',
30 | 'os',
31 | 'crypto',
32 | 'stream',
33 | 'util',
34 | 'events',
35 | 'child_process',
36 | ],
37 | noExternal: ['chalk', 'boxen', 'commander'],
38 | },
39 | ]);
40 |
--------------------------------------------------------------------------------
/src/core/brain/llm/messages/formatters/types.ts:
--------------------------------------------------------------------------------
1 | import { InternalMessage } from '../types.js';
2 |
3 | export interface IMessageFormatter {
4 | /**
5 | * Format a single message into the specific structure of target LLM API.
6 | * This method always returns an array for interface compatibility.
7 | *
8 | * @param message - The message to format.
9 | * @param systemPrompt - Optional system prompt to include.
10 | * @returns Array of formatted messages.
11 | */
12 | format(message: Readonly
17 | {message}
18 |
26 |
27 |
18 |
42 | )
43 | }
--------------------------------------------------------------------------------
/src/app/ui/src/types/api.ts:
--------------------------------------------------------------------------------
1 | // API response types matching Cipher's backend
2 | export interface ApiResponse
19 |
41 |
20 |
27 |
28 | 21 | Something went wrong! 22 |
23 |24 | An error occurred while loading the application. 25 |
26 |
29 |
33 |
34 |
40 | 30 | {error.message || 'Unknown error occurred'} 31 |
32 |
10 |
32 | );
33 | }
--------------------------------------------------------------------------------
/src/core/brain/llm/messages/history/wal.ts:
--------------------------------------------------------------------------------
1 | import { IConversationHistoryProvider } from './types.js';
2 | import { InternalMessage } from '../types.js';
3 |
4 | interface WALEntry {
5 | sessionId: string;
6 | message: InternalMessage;
7 | flushed: boolean;
8 | }
9 |
10 | export class WALHistoryProvider implements IConversationHistoryProvider {
11 | private log: WALEntry[] = [];
12 |
13 | async getHistory(sessionId: string, _limit?: number): Promise
11 |
31 |
12 |
24 |
25 |
13 | 
14 |
15 |
14 |
16 |
23 | 17 | Hello, Welcome to Cipher! 18 |
19 |20 | Create memories, ask anything or connect new tools to expand what you can do. 21 |
22 |
26 | {quickActions.map((action, index) => (
27 |
30 |
15 |
16 |
17 |
25 |
26 |
27 |
38 | )
39 | }
--------------------------------------------------------------------------------
/src/core/vector_storage/types.ts:
--------------------------------------------------------------------------------
1 | /**
2 | * Vector Storage Module Public API
3 | *
4 | * This module re-exports all the necessary types and interfaces for the vector storage system.
5 | * It provides a simplified, clean API surface for consumers of the vector storage module.
6 | *
7 | * The vector storage system architecture:
8 | * - Single backend design for vector similarity search
9 | * - Multiple backend implementations: Qdrant, Pinecone, In-Memory, etc.
10 | * - Consistent API across different backend types
11 | * - Strong type safety with TypeScript and runtime validation with Zod
12 | *
13 | * @module vector_storage
14 | *
15 | * @example
16 | * ```typescript
17 | * import type { VectorStoreConfig, VectorStore } from './vector_storage/types.js';
18 | *
19 | * // Configure vector storage
20 | * const config: VectorStoreConfig = {
21 | * type: 'qdrant',
22 | * host: 'localhost',
23 | * port: 6333,
24 | * collectionName: 'embeddings',
25 | * dimension: 1536
26 | * };
27 | *
28 | * // Use vector store
29 | * const store: VectorStore = createVectorStore(config);
30 | * ```
31 | */
32 |
33 | /**
34 | * Re-export simplified vector storage types
35 | *
36 | * These exports provide the complete type system needed to work with
37 | * the vector storage module without exposing internal implementation details.
38 | */
39 | export type {
40 | // Core interfaces
41 | VectorStore, // Interface for vector store implementations
42 | VectorStoreResult, // Search result structure
43 | SearchFilters, // Metadata filters for search
44 |
45 | // Configuration types
46 | BackendConfig, // Union type for all backend configurations
47 | VectorStoreConfig, // Top-level vector storage system configuration
48 | } from './backend/types.js';
49 |
--------------------------------------------------------------------------------
/src/core/storage/types.ts:
--------------------------------------------------------------------------------
1 | /**
2 | * Storage Module Public API
3 | *
4 | * This module re-exports all the necessary types and interfaces for the storage system.
5 | * It provides a simplified, clean API surface for consumers of the storage module.
6 | *
7 | * The storage system architecture:
8 | * - Dual-backend design: Cache (fast, ephemeral) + Database (persistent, reliable)
9 | * - Multiple backend implementations: Redis, SQLite, In-Memory, etc.
10 | * - Consistent API across different backend types
11 | * - Strong type safety with TypeScript and runtime validation with Zod
12 | *
13 | * @module storage
14 | *
15 | * @example
16 | * ```typescript
17 | * import type { StorageConfig, CacheBackend, DatabaseBackend } from './storage/types.js';
18 | *
19 | * // Configure storage
20 | * const config: StorageConfig = {
21 | * cache: { type: 'redis', host: 'localhost' },
22 | * database: { type: 'sqlite', path: './data' }
23 | * };
24 | *
25 | * // Use backends
26 | * const cache: CacheBackend = createCacheBackend(config.cache);
27 | * const db: DatabaseBackend = createDatabaseBackend(config.database);
28 | * ```
29 | */
30 |
31 | /**
32 | * Re-export simplified storage types
33 | *
34 | * These exports provide the complete type system needed to work with
35 | * the storage module without exposing internal implementation details.
36 | */
37 | export type {
38 | // Backend interfaces
39 | CacheBackend, // Interface for cache storage implementations
40 | DatabaseBackend, // Interface for database storage implementations
41 | StorageBackends, // Combined backends structure
42 |
43 | // Configuration types
44 | BackendConfig, // Union type for all backend configurations
45 | StorageConfig, // Top-level storage system configuration
46 | } from './backend/types.js';
47 |
--------------------------------------------------------------------------------
/src/app/ui/src/components/ui/alert.tsx:
--------------------------------------------------------------------------------
1 | import * as React from "react"
2 | import { cva, type VariantProps } from "class-variance-authority"
3 |
4 | import { cn } from "@/lib/utils"
5 |
6 | const alertVariants = cva(
7 | "relative w-full rounded-lg border px-4 py-3 text-sm [&>svg~*]:pl-7 [&>svg+div]:translate-y-[-3px] [&>svg]:absolute [&>svg]:left-4 [&>svg]:top-4 [&>svg]:text-foreground",
8 | {
9 | variants: {
10 | variant: {
11 | default: "bg-background text-foreground",
12 | destructive:
13 | "border-destructive/50 text-destructive dark:border-destructive [&>svg]:text-destructive",
14 | },
15 | },
16 | defaultVariants: {
17 | variant: "default",
18 | },
19 | }
20 | )
21 |
22 | const Alert = React.forwardRef<
23 | HTMLDivElement,
24 | React.HTMLAttributes
28 |
37 |
29 |
36 |
30 |
31 |
32 |
33 |
34 | Cipher is thinking...
35 |
21 |
49 |
22 |
40 |
41 |
23 |
28 |
29 |
24 |
25 |
26 |
25 | Cipher
27 |
30 | {currentSessionId && !isWelcomeState && (
31 |
32 | {currentSessionId}
33 |
34 | )}
35 |
36 | {/* LLM Model Display - Always show */}
37 |
39 |
23 | {/* Search button - Temporarily disabled */}
24 | {/* */}
33 |
34 | {/* Sessions panel toggle */}
35 |
51 |
52 | {/* Servers/Tools panel toggle */}
53 |
69 |
70 |
71 | );
72 | }
--------------------------------------------------------------------------------
/src/core/brain/llm/messages/history/__test__/wal.test.ts:
--------------------------------------------------------------------------------
1 | import { describe, it, expect, beforeEach } from 'vitest';
2 | import { WALHistoryProvider } from '../wal.js';
3 | import type { InternalMessage } from '../../types.js';
4 |
5 | function makeMessage(content: string): InternalMessage {
6 | return { role: 'user', content };
7 | }
8 |
9 | describe('WALHistoryProvider', () => {
10 | let wal: WALHistoryProvider;
11 | let sessionId: string;
12 |
13 | beforeEach(() => {
14 | sessionId = 'wal-session';
15 | wal = new WALHistoryProvider();
16 | });
17 |
18 | it('appends and retrieves messages', async () => {
19 | await wal.saveMessage(sessionId, makeMessage('a'));
20 | await wal.saveMessage(sessionId, makeMessage('b'));
21 | const history = await wal.getHistory(sessionId);
22 | expect(history.length).toBe(2);
23 | expect(history[0]).toBeDefined();
24 | expect(history[0]?.content).toBe('a');
25 | expect(history[1]).toBeDefined();
26 | expect(history[1]?.content).toBe('b');
27 | });
28 |
29 | it('returns only unflushed entries as pending', async () => {
30 | const msgA = makeMessage('a');
31 | const msgB = makeMessage('b');
32 | await wal.saveMessage(sessionId, msgA);
33 | await wal.saveMessage(sessionId, msgB);
34 | let pending = await wal.getPendingEntries();
35 | expect(pending.length).toBe(2);
36 | await wal.markFlushed(sessionId, msgA);
37 | pending = await wal.getPendingEntries();
38 | expect(pending.length).toBe(1);
39 | expect(pending[0]).toBeDefined();
40 | expect(pending[0]?.message.content).toBe('b');
41 | });
42 |
43 | it('clears history for a session', async () => {
44 | await wal.saveMessage(sessionId, makeMessage('a'));
45 | await wal.saveMessage('other', makeMessage('b'));
46 | await wal.clearHistory(sessionId);
47 | const history = await wal.getHistory(sessionId);
48 | expect(history.length).toBe(0);
49 | const other = await wal.getHistory('other');
50 | expect(other.length).toBe(1);
51 | });
52 | });
53 |
--------------------------------------------------------------------------------
/src/app/ui/src/components/navigation.tsx:
--------------------------------------------------------------------------------
1 | "use client"
2 |
3 | import * as React from "react"
4 | import Link from "next/link"
5 | import { usePathname } from "next/navigation"
6 | import { Button } from "@/components/ui/button"
7 | import { Badge } from "@/components/ui/badge"
8 | import { cn } from "@/lib/utils"
9 | import { Home, Layers, Settings } from "lucide-react"
10 |
11 | export function Navigation() {
12 | const pathname = usePathname()
13 |
14 | const navItems = [
15 | {
16 | name: "Chat",
17 | href: "/",
18 | icon: Home,
19 | description: "Main chat interface"
20 | },
21 | {
22 | name: "Examples",
23 | href: "/examples",
24 | icon: Layers,
25 | description: "View different implementations"
26 | }
27 | ]
28 |
29 | return (
30 |
62 | )
63 | }
--------------------------------------------------------------------------------
/src/core/brain/memAgent/loader.ts:
--------------------------------------------------------------------------------
1 | import { logger } from '../../logger/index.js';
2 | import { AgentConfig } from './config.js';
3 | import { parse as parseYaml } from 'yaml';
4 | import { promises as fs } from 'fs';
5 | import { env } from '../../env.js';
6 |
7 | function expandEnvVars(config: any): any {
8 | if (typeof config === 'string') {
9 | const expanded = config.replace(
10 | /\$([A-Z_][A-Z0-9_]*)|\${([A-Z_][A-Z0-9_]*)}/gi,
11 | (_, v1, v2) => {
12 | const key = v1 || v2;
13 | return (env as any)[key] || '';
14 | }
15 | );
16 |
17 | // Try to convert numeric strings to numbers
18 | if (expanded !== config && /^-?\d+(\.\d+)?([eE][+-]?\d+)?$/.test(expanded.trim())) {
19 | return Number(expanded); // handles int, float, sci-notation
20 | }
21 |
22 | return expanded;
23 | } else if (Array.isArray(config)) {
24 | return config.map(expandEnvVars);
25 | } else if (typeof config === 'object' && config !== null) {
26 | const result: any = {};
27 | for (const key in config) {
28 | result[key] = expandEnvVars(config[key]);
29 | }
30 | return result;
31 | }
32 | return config;
33 | }
34 |
35 | export async function loadAgentConfig(configPath: string): Promise