@boringos/core 0.1.0

package/dist/scheduler.js

@@ -0,0 +1,77 @@
+import { eq } from "drizzle-orm";
+import { routines } from "@boringos/db";
+/**
+ * Simple interval-based routine scheduler.
+ * Checks every 60 seconds for routines whose cron expression matches the current minute.
+ * No external cron library — uses basic time matching.
+ */
+export function createRoutineScheduler(db, engine) {
+    let interval = null;
+    async function tick() {
+        const activeRoutines = await db.select().from(routines).where(eq(routines.status, "active"));
+        for (const routine of activeRoutines) {
+            if (shouldRun(routine.cronExpression, routine.timezone ?? "UTC")) {
+                try {
+                    const outcome = await engine.wake({
+                        agentId: routine.assigneeAgentId,
+                        tenantId: routine.tenantId,
+                        reason: "routine_triggered",
+                    });
+                    if (outcome.kind === "created") {
+                        await engine.enqueue(outcome.wakeupRequestId);
+                    }
+                    await db.update(routines).set({
+                        lastTriggeredAt: new Date(),
+                        updatedAt: new Date(),
+                    }).where(eq(routines.id, routine.id));
+                }
+                catch {
+                    // Routine trigger failure — silently skip this tick
+                }
+            }
+        }
+    }
+    return {
+        start() {
+            // Check every 60 seconds
+            interval = setInterval(() => tick().catch(() => { }), 60_000);
+            // Also run immediately on start
+            tick().catch(() => { });
+        },
+        stop() {
+            if (interval) {
+                clearInterval(interval);
+                interval = null;
+            }
+        },
+    };
+}
+/**
+ * Simple cron expression matcher.
+ * Supports standard 5-field: minute hour day-of-month month day-of-week
+ * Supports: *, specific numbers, and * / step patterns (e.g., * /5 for every 5 minutes)
+ */
+function shouldRun(cronExpression, _timezone) {
+    const now = new Date();
+    const parts = cronExpression.trim().split(/\s+/);
+    if (parts.length !== 5)
+        return false;
+    const [minute, hour, dayOfMonth, month, dayOfWeek] = parts;
+    return (matchField(minute, now.getMinutes()) &&
+        matchField(hour, now.getHours()) &&
+        matchField(dayOfMonth, now.getDate()) &&
+        matchField(month, now.getMonth() + 1) &&
+        matchField(dayOfWeek, now.getDay()));
+}
+function matchField(field, value) {
+    if (field === "*")
+        return true;
+    // Step: */5 means every 5
+    if (field.startsWith("*/")) {
+        const step = parseInt(field.slice(2));
+        return value % step === 0;
+    }
+    // Exact match
+    return parseInt(field) === value;
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"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"}

package/dist/sse-routes.d.ts

@@ -0,0 +1,4 @@
+import { Hono } from "hono";
+import type { RealtimeBus } from "./realtime.js";
+export declare function createSSERoutes(bus: RealtimeBus, adminKey: string): Hono;
+//# sourceMappingURL=sse-routes.d.ts.map

package/dist/sse-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-routes.d.ts","sourceRoot":"","sources":["../src/sse-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAwCxE"}

package/dist/sse-routes.js

@@ -0,0 +1,37 @@
+import { Hono } from "hono";
+import { streamSSE } from "hono/streaming";
+export function createSSERoutes(bus, adminKey) {
+    const app = new Hono();
+    // GET /events — SSE stream, authenticated via API key query param or header
+    app.get("/events", async (c) => {
+        const key = c.req.header("X-API-Key") ?? c.req.query("apiKey");
+        if (!key || key !== adminKey) {
+            return c.json({ error: "Invalid or missing API key" }, 401);
+        }
+        const tenantId = c.req.header("X-Tenant-Id") ?? c.req.query("tenantId");
+        if (!tenantId) {
+            return c.json({ error: "Missing tenant ID" }, 400);
+        }
+        return streamSSE(c, async (stream) => {
+            const unsubscribe = bus.subscribe(tenantId, (event) => {
+                stream.writeSSE({
+                    event: event.type,
+                    data: JSON.stringify(event),
+                });
+            });
+            // Keep connection alive with heartbeat
+            const heartbeat = setInterval(() => {
+                stream.writeSSE({ event: "heartbeat", data: "" });
+            }, 30000);
+            // Clean up on disconnect
+            stream.onAbort(() => {
+                unsubscribe();
+                clearInterval(heartbeat);
+            });
+            // Hold the connection open
+            await new Promise(() => { });
+        });
+    });
+    return app;
+}
+//# sourceMappingURL=sse-routes.js.map

package/dist/sse-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-routes.js","sourceRoot":"","sources":["../src/sse-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,MAAM,UAAU,eAAe,CAAC,GAAgB,EAAE,QAAgB;IAChE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,4EAA4E;IAC5E,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC7B,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC/D,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,4BAA4B,EAAE,EAAE,GAAG,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,GAAG,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACnC,MAAM,WAAW,GAAG,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;gBACpD,MAAM,CAAC,QAAQ,CAAC;oBACd,KAAK,EAAE,KAAK,CAAC,IAAI;oBACjB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;iBAC5B,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,uCAAuC;YACvC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;gBACjC,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YACpD,CAAC,EAAE,KAAK,CAAC,CAAC;YAEV,yBAAyB;YACzB,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;gBAClB,WAAW,EAAE,CAAC;gBACd,aAAa,CAAC,SAAS,CAAC,CAAC;YAC3B,CAAC,CAAC,CAAC;YAEH,2BAA2B;YAC3B,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,81 @@
+import type { MemoryProvider } from "@boringos/memory";
+import type { RuntimeRegistry } from "@boringos/runtime";
+import type { StorageBackend } from "@boringos/drive";
+import type { DatabaseConfig } from "@boringos/db";
+import type { AgentEngine } from "@boringos/agent";
+import type { WorkflowEngine } from "@boringos/workflow";
+import type { SkillProvider } from "@boringos/shared";
+export interface BoringOSConfig {
+    database?: DatabaseConfig;
+    redis?: string;
+    auth?: AuthConfig;
+    drive?: DriveAppConfig;
+    logging?: LogConfig;
+}
+export interface AuthConfig {
+    secret: string;
+    adminKey?: string;
+    url?: string;
+    tokenExpirySeconds?: number;
+}
+export interface DriveAppConfig {
+    root?: string;
+    backend?: StorageBackend;
+}
+export interface LogConfig {
+    level?: "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+    pretty?: boolean;
+}
+export interface AppContext {
+    config: BoringOSConfig;
+    db: unknown;
+    memory: MemoryProvider;
+    drive: StorageBackend | null;
+    runtimes: RuntimeRegistry;
+    agentEngine: AgentEngine | null;
+    workflowEngine: WorkflowEngine | null;
+}
+export interface ConnectorDefinition extends SkillProvider {
+    name: string;
+    type: string;
+    setup?(ctx: AppContext): Promise<void>;
+}
+export interface SkillDefinition {
+    key: string;
+    name: string;
+    source: SkillSource;
+    trustLevel?: "markdown_only" | "assets" | "scripts_executables";
+}
+export type SkillSource = {
+    type: "local";
+    path: string;
+} | {
+    type: "github";
+    repo: string;
+    path?: string;
+    ref?: string;
+} | {
+    type: "url";
+    url: string;
+};
+export interface PersonaBundle {
+    agentsMd?: string;
+    soulMd?: string;
+    heartbeatMd?: string;
+}
+export interface PluginManifest {
+    name: string;
+    version: string;
+    setup(ctx: AppContext): Promise<void>;
+}
+export type LifecycleHook = (ctx: AppContext) => Promise<void>;
+export interface StartedServer {
+    url: string;
+    port: number;
+    context: AppContext;
+    close(): Promise<void>;
+}
+export interface TestInstance extends StartedServer {
+    reset(): Promise<void>;
+}
+//# 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":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@boringos/core",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "license": "MIT",
+  "dependencies": {
+    "better-auth": "^1.6.0",
+    "hono": "^4.7.0",
+    "@hono/node-server": "^1.13.0",
+    "@boringos/shared": "0.1.0",
+    "@boringos/memory": "0.1.0",
+    "@boringos/runtime": "0.1.0",
+    "@boringos/drive": "0.1.0",
+    "@boringos/db": "0.1.0",
+    "@boringos/agent": "0.1.0",
+    "@boringos/pipeline": "0.1.0",
+    "@boringos/connector": "0.1.0",
+    "@boringos/workflow": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.3"
+  },
+  "description": "Application host — the entry point for BoringOS",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BoringOS-dev/boringos.git"
+  },
+  "homepage": "https://boringos.dev",
+  "author": "BoringOS Contributors",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "boringos",
+    "agentic",
+    "ai-agents",
+    "framework"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}