@junejs/server 0.1.0 → 0.1.2-dev.0

package/dist/agent-durable.d.ts

@@ -1,13 +1,14 @@
 import { Channel, ChannelFactory } from "@junejs/core/agent-config";
-import { Model, Msg, SessionStore, Tool } from "@junejs/core/agent-runtime";
+import { InboundEvent, Model, Msg, SessionStore, Tool } from "@junejs/core/agent-runtime";
 import { Resources } from "@junejs/core/resources";
 //#region src/agent-durable.d.ts
-interface SqlStorageCursor<T = Record<string, unknown>> {
+type SqlStorageValue = ArrayBuffer | string | number | null;
+interface SqlStorageCursor<T extends Record<string, SqlStorageValue> = Record<string, SqlStorageValue>> {
   toArray(): T[];
   one(): T;
 }
 interface SqlStorage {
-  exec<T = Record<string, unknown>>(query: string, ...bindings: unknown[]): SqlStorageCursor<T>;
+  exec<T extends Record<string, SqlStorageValue> = Record<string, SqlStorageValue>>(query: string, ...bindings: unknown[]): SqlStorageCursor<T>;
 }
 interface DurableStorage {
   sql: SqlStorage;
@@ -53,6 +54,7 @@ declare class AgentDurableObject {
   turn(input: {
     turnId?: string;
     userText: string;
+    event?: InboundEvent;
   }): Promise<string>;
   transcript(): import("@junejs/core/agent-runtime").Turn[];
   fetch(req: Request): Promise<Response>;
@@ -69,4 +71,4 @@ declare function durableChannelSurface(getNamespace: () => DurableObjectNamespac
   waitUntil?: (p: Promise<unknown>) => void;
 }): (req: Request) => Promise<Response | null>;
 //#endregion
-export { AgentDurableObject, DoAgentDef, DoSessionStore, DurableObjectNamespace, DurableObjectState, DurableObjectStub, DurableStorage, SqlStorage, SqlStorageCursor, durableAgentSurface, durableChannelSurface, durableFetch };
+export { AgentDurableObject, DoAgentDef, DoSessionStore, DurableObjectNamespace, DurableObjectState, DurableObjectStub, DurableStorage, SqlStorage, SqlStorageCursor, SqlStorageValue, durableAgentSurface, durableChannelSurface, durableFetch };

package/dist/agent-durable.js

@@ -85,10 +85,11 @@ var AgentDurableObject = class {
 	async fetch(req) {
 		const url = new URL(req.url);
 		if (req.method === "POST" && url.pathname.endsWith("/turn")) {
-			const { userText, turnId } = await req.json();
+			const { userText, turnId, event } = await req.json();
 			return Response.json({ text: await this.turn({
 				userText,
-				turnId
+				turnId,
+				event
 			}) });
 		}
 		if (url.pathname.endsWith("/transcript")) return Response.json({ transcript: this.transcript() });
@@ -128,14 +129,30 @@ function durableChannelSurface(getNamespace, opts) {
 			if (!namespace) throw new Error("durableChannelSurface: no Durable Object namespace bound (env.AGENT)");
 			const { text } = await (await durableFetch(namespace, opts.agentName, o?.session ?? "default", new Request("https://do/turn", {
 				method: "POST",
-				body: JSON.stringify({
-					userText: message,
-					turnId: o?.turnId
-				})
+				body: serializeTurn(message, o)
 			}))).json();
 			return text;
 		}
 	});
 }
+function serializeTurn(userText, o) {
+	const payload = {
+		userText,
+		turnId: o?.turnId,
+		event: o?.event
+	};
+	try {
+		return JSON.stringify(payload);
+	} catch {
+		const event = o?.event ? {
+			...o.event,
+			raw: void 0
+		} : void 0;
+		return JSON.stringify({
+			...payload,
+			event
+		});
+	}
+}
 //#endregion
 export { AgentDurableObject, DoSessionStore, durableAgentSurface, durableChannelSurface, durableFetch };

package/dist/agent-native.js

@@ -154,7 +154,8 @@ function mountAgent(agent, runtime, opts = {}) {
 		agent,
 		run: (message, o) => runtime.session(agent.name, o?.session ?? "default").turn({
 			turnId: o?.turnId,
-			userText: message
+			userText: message,
+			event: o?.event
 		})
 	};
 	const channels = channelFetch(agent, ctx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@junejs/server",
-  "version": "0.1.0",
+  "version": "0.1.2-dev.0",
   "description": "June host adapters + dev server. Host-coupled; depends on the pure @junejs/core contract layer.",
   "type": "module",
   "license": "MIT",
@@ -125,8 +125,8 @@
     "build": "tsdown"
   },
   "dependencies": {
-    "@junejs/core": ">=0.1.0",
-    "@junejs/db": ">=0.0.33",
+    "@junejs/core": ">=0.1.1-dev.0",
+    "@junejs/db": ">=0.0.34-dev.0",
     "@momiji-rs/sparkdown": "^0.0.4",
     "lightningcss": "^1.27.0",
     "oxc-parser": "^0.137.0",

package/src/agent-durable.ts

@@ -22,6 +22,7 @@ import {
   type Model,
   type Msg,
   type Runtime,
+  type InboundEvent,
   type SessionStore,
   type Tool,
 } from "@junejs/core/agent-runtime";
@@ -37,12 +38,23 @@ import {
 import { ensureScope, runInScope } from "@junejs/db";
 
 // ── minimal structural Cloudflare surface (no @cloudflare/workers-types dep) ──
-export interface SqlStorageCursor<T = Record<string, unknown>> {
+// SqlStorage row values are exactly what workerd's SQLite returns. Mirroring
+// @cloudflare/workers-types' `T extends Record<string, SqlStorageValue>` constraint
+// STRUCTURALLY (not importing it) makes `this.ctx.storage` directly assignable to
+// these interfaces, so a DO shell needs no `as unknown as JuneDoState` cast. The
+// constraint (not just a default) is what lets the two `exec` signatures unify:
+// an unconstrained `T` promises `toArray(): T[]` for arbitrary T, which workerd's
+// cursor — only ever `Record<string, SqlStorageValue>` rows — cannot satisfy.
+export type SqlStorageValue = ArrayBuffer | string | number | null;
+export interface SqlStorageCursor<T extends Record<string, SqlStorageValue> = Record<string, SqlStorageValue>> {
   toArray(): T[];
   one(): T;
 }
 export interface SqlStorage {
-  exec<T = Record<string, unknown>>(query: string, ...bindings: unknown[]): SqlStorageCursor<T>;
+  exec<T extends Record<string, SqlStorageValue> = Record<string, SqlStorageValue>>(
+    query: string,
+    ...bindings: unknown[]
+  ): SqlStorageCursor<T>;
 }
 export interface DurableStorage {
   sql: SqlStorage;
@@ -179,7 +191,7 @@ export class AgentDurableObject {
   // Juno's batch-loader registry) can't leak across turns on a long-lived DO.
   // ensureScope() lazily wires node:async_hooks (workerd via nodejs_compat), as the
   // pipeline does; without it runInScope is a pass-through and ambient reads throw.
-  async turn(input: { turnId?: string; userText: string }): Promise<string> {
+  async turn(input: { turnId?: string; userText: string; event?: InboundEvent }): Promise<string> {
     await ensureScope();
     return runInScope({ resources: this.resources, services: this.services }, () => this.session.turn(input));
   }
@@ -191,8 +203,8 @@ export class AgentDurableObject {
   async fetch(req: Request): Promise<Response> {
     const url = new URL(req.url);
     if (req.method === "POST" && url.pathname.endsWith("/turn")) {
-      const { userText, turnId } = (await req.json()) as { userText: string; turnId?: string };
-      return Response.json({ text: await this.turn({ userText, turnId }) });
+      const { userText, turnId, event } = (await req.json()) as { userText: string; turnId?: string; event?: InboundEvent };
+      return Response.json({ text: await this.turn({ userText, turnId, event }) });
     }
     if (url.pathname.endsWith("/transcript")) return Response.json({ transcript: this.transcript() });
     return new Response("agent DO — POST /turn or GET /transcript", { status: 404 });
@@ -282,7 +294,7 @@ export function durableChannelSurface(
         namespace,
         opts.agentName,
         o?.session ?? "default",
-        new Request("https://do/turn", { method: "POST", body: JSON.stringify({ userText: message, turnId: o?.turnId }) }),
+        new Request("https://do/turn", { method: "POST", body: serializeTurn(message, o) }),
       );
       const { text } = (await res.json()) as { text: string };
       return text;
@@ -290,3 +302,19 @@ export function durableChannelSurface(
   };
   return channelDispatch(resolved, ctx);
 }
+
+// Serialize a turn for the /turn RPC body. InboundEvent.raw is `unknown` — the
+// untouched platform payload — so a (third-party) channel could attach something
+// JSON.stringify chokes on (a circular object, a BigInt). raw isn't needed to route or
+// run the turn, so on a serialization failure we drop it rather than let an
+// unserializable payload take down turn forwarding entirely. (raw is optional on
+// InboundEvent precisely because it may not survive this boundary.)
+function serializeTurn(userText: string, o?: { turnId?: string; event?: InboundEvent }): string {
+  const payload = { userText, turnId: o?.turnId, event: o?.event };
+  try {
+    return JSON.stringify(payload);
+  } catch {
+    const event = o?.event ? { ...o.event, raw: undefined } : undefined;
+    return JSON.stringify({ ...payload, event });
+  }
+}

package/src/agent-native.ts

@@ -207,7 +207,7 @@ export function mountAgent(
   const ctx: ChannelContext = {
     agent,
     run: (message, o) =>
-      runtime.session(agent.name, o?.session ?? "default").turn({ turnId: o?.turnId, userText: message }),
+      runtime.session(agent.name, o?.session ?? "default").turn({ turnId: o?.turnId, userText: message, event: o?.event }),
   };
   const channels = channelFetch(agent, ctx);
   const surface = async (req: Request): Promise<Response | null> => {