@holon-run/uxc-daemon-client 0.18.0 → 0.20.0

package/dist/index.cjs

@@ -109,6 +109,16 @@ var UxcDaemonClient = class {
     });
     return generateTypeScriptClient(schema, args.emitter);
   }
+  async emailSend(args) {
+    return this.request("email.send", emailSendParams(args));
+  }
+  async emailReply(args) {
+    const { replyHandle, ...send } = args;
+    return this.request("email.reply", {
+      ...emailSendParams(send),
+      ...replyHandle ? { reply_handle: emailReplyHandleParams(replyHandle) } : {}
+    });
+  }
   async sourceEnsure(args) {
     return this.request("source.ensure", {
       namespace: args.namespace,
@@ -628,6 +638,35 @@ function defaultSocketPath(env) {
   const label = bestEffortUserLabel(env);
   return (0, import_node_path.join)((0, import_node_os.tmpdir)(), `uxc-${label}`, "daemon", "uxc.sock");
 }
+function emailSendParams(args) {
+  const params = {
+    smtp_url: args.smtpUrl,
+    from: args.from,
+    to: args.to,
+    subject: args.subject
+  };
+  if (args.cc?.length) params.cc = args.cc;
+  if (args.bcc?.length) params.bcc = args.bcc;
+  if (args.text != null) params.text = args.text;
+  if (args.html != null) params.html = args.html;
+  if (args.inReplyTo != null) params.in_reply_to = args.inReplyTo;
+  if (args.references?.length) params.references = args.references;
+  if (args.auth != null) params.auth = args.auth;
+  if (args.messageId != null) params.message_id = args.messageId;
+  if (args.allowInsecureAuth != null) params.allow_insecure_auth = args.allowInsecureAuth;
+  if (args.dryRun != null) params.dry_run = args.dryRun;
+  return params;
+}
+function emailReplyHandleParams(replyHandle) {
+  if (replyHandle.messageId == null) {
+    throw new Error("emailReply replyHandle requires messageId");
+  }
+  const params = { message_id: replyHandle.messageId };
+  if (replyHandle.account != null) params.account = replyHandle.account;
+  if (replyHandle.mailbox != null) params.mailbox = replyHandle.mailbox;
+  if (replyHandle.uid != null) params.uid = replyHandle.uid;
+  return params;
+}
 function bestEffortUserLabel(env) {
   const raw = env?.USER ?? env?.USERNAME ?? "unknown";
   const filtered = raw.replace(/[^A-Za-z0-9_-]/g, "_");

package/dist/index.d.cts

@@ -81,7 +81,7 @@ interface ManagedSourceSpec {
     args?: Record<string, unknown> | null;
     resource_uri?: string | null;
     read_resource?: boolean;
-    transport_hint?: "websocket" | "discord_gateway" | "slack_socket_mode" | "feishu_long_connection" | null;
+    transport_hint?: "websocket" | "discord_gateway" | "slack_socket_mode" | "feishu_long_connection" | "email_imap_idle" | "email_provider_poll" | null;
     subprotocols?: string[];
     initial_text_frames?: string[];
     mode: "stream" | "poll";
@@ -97,6 +97,45 @@ interface ManagedSourceEnsureResponse {
     reused: boolean;
     replaced_previous: boolean;
 }
+interface EmailSendResult {
+    smtp_url: string;
+    from: string;
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject: string;
+    message_id: string;
+    in_reply_to?: string | null;
+    references?: string[];
+    dry_run: boolean;
+    accepted_recipients: number;
+}
+interface EmailReplyHandle {
+    messageId?: string;
+    account?: string;
+    mailbox?: string;
+    uid?: number;
+}
+interface EmailSendArgs {
+    smtpUrl: string;
+    from: string;
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject: string;
+    text?: string;
+    html?: string;
+    inReplyTo?: string;
+    references?: string[];
+    auth?: string;
+    /** Caller-supplied Message-ID used for outbound idempotency. */
+    messageId?: string;
+    allowInsecureAuth?: boolean;
+    dryRun?: boolean;
+}
+interface EmailReplyArgs extends EmailSendArgs {
+    replyHandle?: EmailReplyHandle | null;
+}
 interface ManagedSourceView {
     namespace: string;
     source_key: string;
@@ -197,6 +236,15 @@ interface PollSubscriptionConfig {
     response_cursor_pointer?: string;
     cursor_from_item_pointer?: string;
     cursor_transform?: "increment";
+    /**
+     * First-look backfill depth. When set, only the initial poll cycle after a
+     * fresh checkpoint emits items: the whole first page is recorded in the
+     * checkpoint, but at most this many unseen items are emitted. `0`
+     * establishes the baseline without emitting anything ("new items only").
+     * Later cycles are unaffected. Requires the item_key, watermark, or
+     * content_hash checkpoint strategy.
+     */
+    initial_items_limit?: number;
     checkpoint_strategy: {
         type: "cursor_only";
     } | {
@@ -245,6 +293,8 @@ declare class UxcDaemonClient {
         options?: RuntimeInvokeOptions;
         emitter?: GenerateTypeScriptClientOptions;
     }): Promise<string>;
+    emailSend(args: EmailSendArgs): Promise<EmailSendResult>;
+    emailReply(args: EmailReplyArgs): Promise<EmailSendResult>;
     sourceEnsure(args: {
         namespace: string;
         sourceKey: string;
@@ -268,4 +318,4 @@ declare class UxcDaemonClient {
 }
 declare function generateTypeScriptClient(schema: CodegenHostSchemaV1, options?: GenerateTypeScriptClientOptions): string;
 
-export { type CodegenHostSchemaV1, type CodegenOperationV1, DaemonRpcError, type DaemonSessionKillResponse, type DaemonStatus, type GenerateTypeScriptClientOptions, type ManagedSourceDeleteResponse, type ManagedSourceEnsureResponse, type ManagedSourceListEntry, type ManagedSourceSpec, type ManagedSourceStopResponse, type ManagedSourceView, type ManagedStreamEvent, type ManagedStreamInfo, type ManagedStreamReadResponse, type ManagedStreamTrimResponse, type PollSubscriptionConfig, type RuntimeInvokeOptions, type RuntimeInvokeResponse, type RuntimeMeta, type RuntimeResult, UxcDaemonClient, type UxcDaemonClientOptions, generateTypeScriptClient };
+export { type CodegenHostSchemaV1, type CodegenOperationV1, DaemonRpcError, type DaemonSessionKillResponse, type DaemonStatus, type EmailReplyArgs, type EmailReplyHandle, type EmailSendArgs, type EmailSendResult, type GenerateTypeScriptClientOptions, type ManagedSourceDeleteResponse, type ManagedSourceEnsureResponse, type ManagedSourceListEntry, type ManagedSourceSpec, type ManagedSourceStopResponse, type ManagedSourceView, type ManagedStreamEvent, type ManagedStreamInfo, type ManagedStreamReadResponse, type ManagedStreamTrimResponse, type PollSubscriptionConfig, type RuntimeInvokeOptions, type RuntimeInvokeResponse, type RuntimeMeta, type RuntimeResult, UxcDaemonClient, type UxcDaemonClientOptions, generateTypeScriptClient };

package/dist/index.d.ts

@@ -81,7 +81,7 @@ interface ManagedSourceSpec {
     args?: Record<string, unknown> | null;
     resource_uri?: string | null;
     read_resource?: boolean;
-    transport_hint?: "websocket" | "discord_gateway" | "slack_socket_mode" | "feishu_long_connection" | null;
+    transport_hint?: "websocket" | "discord_gateway" | "slack_socket_mode" | "feishu_long_connection" | "email_imap_idle" | "email_provider_poll" | null;
     subprotocols?: string[];
     initial_text_frames?: string[];
     mode: "stream" | "poll";
@@ -97,6 +97,45 @@ interface ManagedSourceEnsureResponse {
     reused: boolean;
     replaced_previous: boolean;
 }
+interface EmailSendResult {
+    smtp_url: string;
+    from: string;
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject: string;
+    message_id: string;
+    in_reply_to?: string | null;
+    references?: string[];
+    dry_run: boolean;
+    accepted_recipients: number;
+}
+interface EmailReplyHandle {
+    messageId?: string;
+    account?: string;
+    mailbox?: string;
+    uid?: number;
+}
+interface EmailSendArgs {
+    smtpUrl: string;
+    from: string;
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject: string;
+    text?: string;
+    html?: string;
+    inReplyTo?: string;
+    references?: string[];
+    auth?: string;
+    /** Caller-supplied Message-ID used for outbound idempotency. */
+    messageId?: string;
+    allowInsecureAuth?: boolean;
+    dryRun?: boolean;
+}
+interface EmailReplyArgs extends EmailSendArgs {
+    replyHandle?: EmailReplyHandle | null;
+}
 interface ManagedSourceView {
     namespace: string;
     source_key: string;
@@ -197,6 +236,15 @@ interface PollSubscriptionConfig {
     response_cursor_pointer?: string;
     cursor_from_item_pointer?: string;
     cursor_transform?: "increment";
+    /**
+     * First-look backfill depth. When set, only the initial poll cycle after a
+     * fresh checkpoint emits items: the whole first page is recorded in the
+     * checkpoint, but at most this many unseen items are emitted. `0`
+     * establishes the baseline without emitting anything ("new items only").
+     * Later cycles are unaffected. Requires the item_key, watermark, or
+     * content_hash checkpoint strategy.
+     */
+    initial_items_limit?: number;
     checkpoint_strategy: {
         type: "cursor_only";
     } | {
@@ -245,6 +293,8 @@ declare class UxcDaemonClient {
         options?: RuntimeInvokeOptions;
         emitter?: GenerateTypeScriptClientOptions;
     }): Promise<string>;
+    emailSend(args: EmailSendArgs): Promise<EmailSendResult>;
+    emailReply(args: EmailReplyArgs): Promise<EmailSendResult>;
     sourceEnsure(args: {
         namespace: string;
         sourceKey: string;
@@ -268,4 +318,4 @@ declare class UxcDaemonClient {
 }
 declare function generateTypeScriptClient(schema: CodegenHostSchemaV1, options?: GenerateTypeScriptClientOptions): string;
 
-export { type CodegenHostSchemaV1, type CodegenOperationV1, DaemonRpcError, type DaemonSessionKillResponse, type DaemonStatus, type GenerateTypeScriptClientOptions, type ManagedSourceDeleteResponse, type ManagedSourceEnsureResponse, type ManagedSourceListEntry, type ManagedSourceSpec, type ManagedSourceStopResponse, type ManagedSourceView, type ManagedStreamEvent, type ManagedStreamInfo, type ManagedStreamReadResponse, type ManagedStreamTrimResponse, type PollSubscriptionConfig, type RuntimeInvokeOptions, type RuntimeInvokeResponse, type RuntimeMeta, type RuntimeResult, UxcDaemonClient, type UxcDaemonClientOptions, generateTypeScriptClient };
+export { type CodegenHostSchemaV1, type CodegenOperationV1, DaemonRpcError, type DaemonSessionKillResponse, type DaemonStatus, type EmailReplyArgs, type EmailReplyHandle, type EmailSendArgs, type EmailSendResult, type GenerateTypeScriptClientOptions, type ManagedSourceDeleteResponse, type ManagedSourceEnsureResponse, type ManagedSourceListEntry, type ManagedSourceSpec, type ManagedSourceStopResponse, type ManagedSourceView, type ManagedStreamEvent, type ManagedStreamInfo, type ManagedStreamReadResponse, type ManagedStreamTrimResponse, type PollSubscriptionConfig, type RuntimeInvokeOptions, type RuntimeInvokeResponse, type RuntimeMeta, type RuntimeResult, UxcDaemonClient, type UxcDaemonClientOptions, generateTypeScriptClient };

package/dist/index.js

@@ -73,6 +73,16 @@ var UxcDaemonClient = class {
     });
     return generateTypeScriptClient(schema, args.emitter);
   }
+  async emailSend(args) {
+    return this.request("email.send", emailSendParams(args));
+  }
+  async emailReply(args) {
+    const { replyHandle, ...send } = args;
+    return this.request("email.reply", {
+      ...emailSendParams(send),
+      ...replyHandle ? { reply_handle: emailReplyHandleParams(replyHandle) } : {}
+    });
+  }
   async sourceEnsure(args) {
     return this.request("source.ensure", {
       namespace: args.namespace,
@@ -592,6 +602,35 @@ function defaultSocketPath(env) {
   const label = bestEffortUserLabel(env);
   return join(tmpdir(), `uxc-${label}`, "daemon", "uxc.sock");
 }
+function emailSendParams(args) {
+  const params = {
+    smtp_url: args.smtpUrl,
+    from: args.from,
+    to: args.to,
+    subject: args.subject
+  };
+  if (args.cc?.length) params.cc = args.cc;
+  if (args.bcc?.length) params.bcc = args.bcc;
+  if (args.text != null) params.text = args.text;
+  if (args.html != null) params.html = args.html;
+  if (args.inReplyTo != null) params.in_reply_to = args.inReplyTo;
+  if (args.references?.length) params.references = args.references;
+  if (args.auth != null) params.auth = args.auth;
+  if (args.messageId != null) params.message_id = args.messageId;
+  if (args.allowInsecureAuth != null) params.allow_insecure_auth = args.allowInsecureAuth;
+  if (args.dryRun != null) params.dry_run = args.dryRun;
+  return params;
+}
+function emailReplyHandleParams(replyHandle) {
+  if (replyHandle.messageId == null) {
+    throw new Error("emailReply replyHandle requires messageId");
+  }
+  const params = { message_id: replyHandle.messageId };
+  if (replyHandle.account != null) params.account = replyHandle.account;
+  if (replyHandle.mailbox != null) params.mailbox = replyHandle.mailbox;
+  if (replyHandle.uid != null) params.uid = replyHandle.uid;
+  return params;
+}
 function bestEffortUserLabel(env) {
   const raw = env?.USER ?? env?.USERNAME ?? "unknown";
   const filtered = raw.replace(/[^A-Za-z0-9_-]/g, "_");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holon-run/uxc-daemon-client",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "Thin Node.js client for UXC daemon-backed operations",
   "license": "MIT",
   "repository": {