@junejs/server 0.1.2 → 0.2.0

package/dist/agent-durable.d.ts

@@ -1,73 +1,148 @@
 import { Channel, ChannelFactory } from "@junejs/core/agent-config";
-import { Model, Msg, SessionStore, Tool } from "@junejs/core/agent-runtime";
+import { AuthorizeAnswer, ChannelPolicy, InboundEvent, InputAnnouncement, Model, Msg, NoteKind, ProactiveTrigger, SessionStore, Tool, TurnError, TurnEvent, TurnFailurePhase } from "@junejs/core/agent-runtime";
+import { FileStore } from "@junejs/core/agent-files";
+import { Connection } from "@junejs/core/connections";
 import { Resources } from "@junejs/core/resources";
 //#region src/agent-durable.d.ts
-type SqlStorageValue = ArrayBuffer | string | number | null;
-interface SqlStorageCursor<T extends Record<string, SqlStorageValue> = Record<string, SqlStorageValue>> {
+export type SqlStorageValue = ArrayBuffer | string | number | null;
+export interface SqlStorageCursor<T extends Record<string, SqlStorageValue> = Record<string, SqlStorageValue>> {
   toArray(): T[];
   one(): T;
 }
-interface SqlStorage {
+export interface SqlStorage {
   exec<T extends Record<string, SqlStorageValue> = Record<string, SqlStorageValue>>(query: string, ...bindings: unknown[]): SqlStorageCursor<T>;
 }
-interface DurableStorage {
+export interface DurableStorage {
   sql: SqlStorage;
   transactionSync<T>(fn: () => T): T;
+  setAlarm?(scheduledTime: number): unknown;
 }
-interface DurableObjectState {
+export interface DurableObjectState {
   storage: DurableStorage;
 }
-interface DurableObjectStub {
+export interface DurableObjectStub {
   fetch(request: Request): Promise<Response>;
 }
-interface DurableObjectNamespace {
+export interface DurableObjectNamespace {
   idFromName(name: string): unknown;
   get(id: unknown): DurableObjectStub;
 }
-declare class DoSessionStore implements SessionStore {
+export declare class DoSessionStore implements SessionStore {
   private readonly storage;
   constructor(storage: DurableStorage);
   private get sql();
   appendMessage(m: Msg): void;
   messages(): Msg[];
-  hasUserTurn(turnId: string): boolean;
+  hasOpeningMessage(turnId: string): boolean;
   getStep(id: string): unknown | undefined;
   putStep(id: string, output: unknown): void;
+  delStep(id: string): void;
   getStatus(): string;
   setStatus(s: string): void;
+  getSessionKey(): string | undefined;
+  setSessionKey(key: string): void;
   tx<T>(fn: () => T): T;
+  reset(inTx?: () => void): number;
   unwrap<H = unknown>(): H;
 }
-type DoAgentDef = {
+export type DoAgentDef = {
   name?: string;
   model: Model;
   tools: Tool[];
   instructions?: string;
-  resources?: Resources;
+  channelInstructions?: Record<string, string | ChannelPolicy>;
+  channels?: (Channel | ChannelFactory)[];
+  env?: unknown;
+  resources?: Resources | ((env: unknown) => Promise<Resources> | Resources);
+  connections?: Connection[];
   services?: unknown;
+  onTurnError?: (failure: {
+    turnId: string;
+    error: TurnError;
+    phase?: TurnFailurePhase;
+    step?: string;
+  }) => void | Promise<void>;
+  authorizeAnswer?: AuthorizeAnswer;
+  onInputAnnouncement?: (a: InputAnnouncement) => void | Promise<void>;
+  files?: FileStore;
 };
-declare class AgentDurableObject {
+export declare class AgentDurableObject {
   private session;
-  private readonly resources;
+  private sessionKey;
+  private readonly name;
+  private readonly store;
+  private readonly sink;
+  private readonly model;
+  private readonly tools;
+  private readonly channels;
+  private readonly channelInstructions?;
+  private readonly resourcesInput;
+  private resourcesOpened;
+  private readonly connectionsInput;
+  private connectionsOpened;
+  private readonly doEnv;
   private readonly services;
+  private readonly authorizeAnswer?;
+  private readonly onInputAnnouncement?;
+  private readonly storage;
+  private readonly files;
+  private announceFailures;
+  private resolveResources;
+  private resolveConnections;
+  private ready;
   constructor(state: DurableObjectState, def: DoAgentDef);
+  private resolveSession;
+  alarm(): Promise<void>;
+  private armWatchdog;
+  private scheduleAlarm;
+  private deliverHeld;
   turn(input: {
     turnId?: string;
     userText: string;
+    event?: InboundEvent;
+    trigger?: ProactiveTrigger;
+    session?: string;
   }): Promise<string>;
+  start(input: {
+    turnId?: string;
+    userText: string;
+    event?: InboundEvent;
+    trigger?: ProactiveTrigger;
+    session?: string;
+  }): Promise<{
+    turnId: string;
+  }>;
+  note(input: {
+    by: string;
+    kind: NoteKind;
+    text: string;
+    session?: string;
+  }): Promise<{
+    noteId: string;
+  }>;
+  reset(opts?: {
+    session?: string;
+  }): Promise<{
+    previousSession: string;
+    generation: number;
+  }>;
   transcript(): import("@junejs/core/agent-runtime").Turn[];
   fetch(req: Request): Promise<Response>;
 }
-declare function durableFetch(namespace: DurableObjectNamespace, agent: string, session: string, req: Request): Promise<Response>;
-declare function durableAgentSurface(getNamespace: () => DurableObjectNamespace | undefined, opts: {
+export declare function sseTurnFinalText(res: Response): Promise<string>;
+export declare function sseTurnEvents(res: Response): AsyncIterable<TurnEvent>;
+export declare const SESSION_HEADER = "x-june-session";
+export declare function durableFetch(namespace: DurableObjectNamespace, agent: string, session: string, req: Request): Promise<Response>;
+export declare function durableAgentSurface(getNamespace: () => DurableObjectNamespace | undefined, opts: {
   agentName: string;
   chatPath?: string;
 }): (req: Request) => Promise<Response | null>;
-declare function durableChannelSurface(getNamespace: () => DurableObjectNamespace | undefined, opts: {
+export declare function durableChannelSurface(getNamespace: () => DurableObjectNamespace | undefined, opts: {
   agentName: string;
   channels: (Channel | ChannelFactory)[];
   env: unknown;
+  services?: (env: unknown) => unknown;
   waitUntil?: (p: Promise<unknown>) => void;
+  files?: FileStore;
 }): (req: Request) => Promise<Response | null>;
-//#endregion
-export { AgentDurableObject, DoAgentDef, DoSessionStore, DurableObjectNamespace, DurableObjectState, DurableObjectStub, DurableStorage, SqlStorage, SqlStorageCursor, SqlStorageValue, durableAgentSurface, durableChannelSurface, durableFetch };
+//#endregion