merco-agents 0.1.4 → 0.1.6

package/index.d.ts

@@ -36,14 +36,30 @@ export declare class JsAgent {
   callStreamWithSession(task: JsTask, sessionKey: string | undefined | null, handler: JsStreamingHandler): Promise<void>
 }
 
+/**
+ * JavaScript callback-based custom storage handler
+ * Allows TypeScript/JavaScript users to implement storage directly via callbacks
+ */
+export declare class JsCustomStorageBuilder {
+  static new(): JsCustomStorageBuilder
+  withInitialize(callback: (arg: InitializeOperation) => void): NapiResult<JsCustomStorageBuilder>
+  withCreateSession(callback: (arg: CreateSessionOperation) => void): NapiResult<JsCustomStorageBuilder>
+  withGetSession(callback: (arg: GetSessionOperation) => void): NapiResult<JsCustomStorageBuilder>
+  withListSessions(callback: (arg: ListSessionsOperation) => void): NapiResult<JsCustomStorageBuilder>
+  withUpdateSession(callback: (arg: UpdateSessionOperation) => void): NapiResult<JsCustomStorageBuilder>
+  withDeleteSession(callback: (arg: DeleteSessionOperation) => void): NapiResult<JsCustomStorageBuilder>
+  withClose(callback: (arg: CloseOperation) => void): NapiResult<JsCustomStorageBuilder>
+  build(): Promise<NapiResult<JsStorageHandler>>
+}
+
 /** JavaScript wrapper for Session */
 export declare class JsSession {
   /** Create a new session */
   static new(name: string): JsSession
   /** Create a session with description */
   static withDescription(name: string, description: string): JsSession
-  /** Get session ID */
-  get id(): bigint
+  /** Get session ID as string to avoid precision loss with large u64 values */
+  get id(): string
   /** Get session name */
   get name(): string
   /** Get session description */
@@ -120,6 +136,37 @@ export declare class JsTask {
 /** Create a new agent using the builder pattern */
 export declare function agentBuilder(): Promise<AgentBuilderWrapper>
 
+/** Typed parameter for close operation */
+export interface CloseOperation {
+  operationId: string
+}
+
+/** Typed parameter for create session operation */
+export interface CreateSessionOperation {
+  operationId: string
+  /** Session as JSON string (can be parsed to JsSession using JsSession::from_json) */
+  sessionJson: string
+}
+
+/** Typed parameter for delete session operation */
+export interface DeleteSessionOperation {
+  operationId: string
+  /** Session ID as string to avoid precision loss with large u64 values */
+  sessionId: string
+}
+
+/** Typed parameter for get session operation */
+export interface GetSessionOperation {
+  operationId: string
+  /** Session ID as string to avoid precision loss with large u64 values */
+  sessionId: string
+}
+
+/** Typed parameter for initialize operation */
+export interface InitializeOperation {
+  operationId: string
+}
+
 /** JavaScript representation of AgentCapabilities */
 export interface JsAgentCapabilities {
   maxConcurrentTasks: number
@@ -379,6 +426,11 @@ export interface JsToolCallStreaming {
   partialArgs: string
 }
 
+/** Typed parameter for list sessions operation */
+export interface ListSessionsOperation {
+  operationId: string
+}
+
 /** Create storage from URL */
 export declare function storageCreateFromUrl(url: string): Promise<JsStorageHandler>
 
@@ -388,6 +440,21 @@ export declare function storageCreatePostgres(config: JsPostgresConfig): Promise
 /** Create SQLite storage */
 export declare function storageCreateSqlite(config: JsSqliteConfig): Promise<JsStorageHandler>
 
+/**
+ * Helper function for JS to complete get_session operation
+ * session_json: JSON string of the session, or null/empty string if not found
+ */
+export declare function storageOperationCompleteSession(operationId: string, sessionJson?: string | undefined | null, error?: string | undefined | null): NapiResult<undefined>
+
+/**
+ * Helper function for JS to complete list_sessions operation
+ * sessions_json: JSON array string where each element is a session JSON string
+ */
+export declare function storageOperationCompleteSessions(operationId: string, sessionsJson: string, error?: string | undefined | null): NapiResult<undefined>
+
+/** Helper function for JS to complete storage operations with void result */
+export declare function storageOperationCompleteVoid(operationId: string, error?: string | undefined | null): NapiResult<undefined>
+
 /**
  * Store result from tool call start callback (called from JS side)
  * The JS callback should call this function with the execution_id and allow boolean
@@ -421,3 +488,10 @@ export declare function toolRegister(name: string, description: string, paramete
  * This function is kept for API compatibility but does nothing.
  */
 export declare function toolUnregister(name: string): void
+
+/** Typed parameter for update session operation */
+export interface UpdateSessionOperation {
+  operationId: string
+  /** Session as JSON string (can be parsed to JsSession using JsSession::from_json) */
+  sessionJson: string
+}

package/index.js

@@ -576,19 +576,16 @@ module.exports.AgentBuilderWrapper = nativeBinding.AgentBuilderWrapper
 module.exports.JsAgent = nativeBinding.JsAgent
 module.exports.JsSession = nativeBinding.JsSession
 module.exports.JsStorageHandler = nativeBinding.JsStorageHandler
-module.exports.JsStreamingHandler = nativeBinding.JsStreamingHandler
 module.exports.JsTask = nativeBinding.JsTask
 module.exports.agentBuilder = nativeBinding.agentBuilder
-module.exports.JsChunkType = nativeBinding.JsChunkType
 module.exports.JsJsonFieldType = nativeBinding.JsJsonFieldType
 module.exports.JsOutputFormat = nativeBinding.JsOutputFormat
 module.exports.JsProvider = nativeBinding.JsProvider
-module.exports.JsReasoningEffort = nativeBinding.JsReasoningEffort
 module.exports.storageCreateFromUrl = nativeBinding.storageCreateFromUrl
 module.exports.storageCreatePostgres = nativeBinding.storageCreatePostgres
 module.exports.storageCreateSqlite = nativeBinding.storageCreateSqlite
-module.exports.toolCallStartComplete = nativeBinding.toolCallStartComplete
-module.exports.toolCompleteExecution = nativeBinding.toolCompleteExecution
 module.exports.toolList = nativeBinding.toolList
 module.exports.toolRegister = nativeBinding.toolRegister
 module.exports.toolUnregister = nativeBinding.toolUnregister
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "merco-agents",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "A powerful Rust library for building intelligent AI agents with Node.js bindings",
   "main": "index.js",
   "types": "index.d.ts",