@atomicmail/agent-skill-openclaw 0.3.24

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Atomic Mail
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,182 @@
+Install package for openclaw integration (same as @atomicmail/agent-skill).
+
+---
+description: Install and run the @atomicmail/agent-skill-gh-pages CLI (register, jmap_request, help) for shell-capable agents and automation.
+---
+
+# @atomicmail/agent-skill-gh-pages
+
+Atomic Mail AgentSkill CLI for shell-capable AI agents. It exposes three
+commands: `register`, `jmap_request`, and `help`. **`jmap_request`** uses the
+same shared library as **`@atomicmail/mcp-gh-pages`**.
+
+## For AI agents — run `atomicmail help`
+
+**Invoke `atomicmail help` before improvising JMAP or preset details.** The CLI
+embeds the topic docs — written for agents,
+version-matched to your install, and cheaper to fetch on demand than reconstructing
+placeholder grammar or attachment flows from memory.
+
+**When to call help:** at the start of a mail task (`atomicmail help` or
+`help --topic overview`); before custom batches (`help --topic presets` and
+`help --topic jmap_cheatsheet`); right after `register` (`help --topic cron`
+for hourly inbox polling after `register`); when errors mention missing
+placeholders, auth, or an old preset file on disk (`help --topic
+troubleshooting`). Prefer the installed binary over static README copies in
+other repos — **trust `help` from the package you are running**.
+
+## Install / run
+
+```bash
+npx --package=@atomicmail/agent-skill-gh-pages atomicmail --help
+```
+
+## Quick start
+
+```bash
+npx --package=@atomicmail/agent-skill-gh-pages atomicmail register \
+  --username "myagent"
+
+npx --package=@atomicmail/agent-skill-gh-pages atomicmail jmap_request \
+  --ops '[["Mailbox/get", {"accountId": "$ACCOUNT_ID"}, "m0"]]'
+```
+
+Usernames must be 5–21 characters (local-part of your `@atomicmail.ai`
+address).
+
+If credentials already exist for a different username, `register` fails by
+default. Pass `--forced` only after backing up the credential directory.
+
+## After register: hourly inbox polling
+
+After `register`, arrange hourly inbox polling per your runtime. **Native cron
+hosts** (OpenClaw, Hermes, atomic-agent) schedule an **hourly AI agent** to
+fetch and triage mail with preset `list_inbox.json`. **Hosts without native
+cron** should ask the operator to set up polling on a capable host, or remind
+manual fetch — do **not** work around with OS schedulers or cross-platform
+scheduling. Do **not** cron `atomicmail jmap_request` alone.
+
+**Hermes users:** follow [Hermes Agent](#hermes-agent) — accept the skill
+blueprint via `/suggestions` after `register`.
+
+Options and agent prompt:
+[`SKILL.md`](./SKILL.md#hourly-inbox-polling-after-register) · `atomicmail help --topic cron`
+· MCP `help` topic `cron`
+
+## Hermes Agent
+
+Hermes ships a bundled Atomic Mail skill with a launcher CLI and an hourly inbox
+blueprint. Requires [Hermes](https://hermes-agent.nousresearch.com) with the
+skills toolset and Node.js 20+ (for the bundled launcher).
+
+### Install
+
+Unified in-repo tap (updated on each GitHub release):
+
+```bash
+hermes skills install Atomic-Mail/atomic-mail-agentic/integrations/skill/atomicmail
+```
+
+### Credentials
+
+On Hermes the default credential directory is **`~/.hermes/atomicmail`**, not
+`~/.atomicmail` (used by npm/npx AgentSkill and MCP defaults).
+
+The skill launcher sets `ATOMIC_MAIL_CREDENTIALS_DIR` to `$HOME/.hermes/atomicmail`
+when that variable is **not** already set. Override explicitly with
+`ATOMIC_MAIL_CREDENTIALS_DIR` or `atomicmail.credentials_dir` in Hermes config.
+
+| Runtime | Default credentials dir |
+| ------- | ----------------------- |
+| Hermes skill | `~/.hermes/atomicmail` |
+| npm/npx AgentSkill, MCP | `~/.atomicmail` |
+
+Files in each directory (mode `0600`): `credentials.json`, `session.jwt`,
+`capability.jwt`.
+
+### Register
+
+Use the skill's bundled CLI — no `npx`:
+
+```bash
+atomicmail register --username "myagent"
+```
+
+The launcher handles the credentials directory; omit `--credentials-dir` in the
+default single-inbox flow. For **multiple inboxes**, pass `--credentials-dir`
+with a separate directory per account on `register` and `jmap_request`.
+
+### After register (required)
+
+1. Run `/suggestions` in Hermes and **accept** the Atomic Mail hourly inbox
+   blueprint.
+2. The blueprint schedules a full **agent** turn (`no_agent: false`) with
+   `list_inbox.json` and `deliver: origin`. Do **not** skip this step.
+3. Do **not** cron raw `jmap_request` alone or use `--no-agent` (no LLM triage).
+
+**Manual fallback** if you skip the blueprint:
+
+```bash
+hermes cron create "0 * * * *" \
+  "Use atomicmail jmap_request --ops-file list_inbox.json to fetch my inbox. Summarize new messages, highlight what needs a reply, and stay available — I may ask you to reply, forward, search, or dig into something important." \
+  --name "atomicmail-inbox" \
+  --deliver origin
+```
+
+See `atomicmail help --topic cron` for the full prompt and delivery options.
+
+### Links
+
+- Hermes creating skills (blueprints):
+  https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills
+- Hermes cron (manual fallback):
+  https://hermes-agent.nousresearch.com/docs/user-guide/features/cron
+- Maintainer publish workflow:
+  [CONTRIBUTING.md](https://github.com/Atomic-Mail/atomic-mail-agentic/blob/develop/CONTRIBUTING.md)
+  (unified skill section)
+
+## `jmap_request`, presets, and placeholders
+
+`jmap_request` accepts inline `--ops` JSON or `--ops-file` (same shapes as MCP:
+methodCalls array or full `{ "using", "methodCalls" }`). Pass custom
+`$PLACEHOLDERS` via `--vars '{"PLACEHOLDER":"value"}'` (keys without `$`).
+
+```bash
+npx --package=@atomicmail/agent-skill-gh-pages atomicmail jmap_request \
+  --ops-file send_mail.json \
+  --vars '{"TO":"alice@example.com","SUBJECT":"Hello","BODY":"Hi there"}'
+```
+
+**Resolution:** relative `--ops-file` resolves to `--credentials-dir` (default
+`~/.atomicmail`), then bundled presets.
+
+**Details** (placeholder grammar, built-ins, shadowing, bundled preset list,
+attachments): see [@atomicmail/mcp-gh-pages](./mcp.md) and the embedded **`help`** topic
+**`presets`** (`atomicmail help --topic presets`).
+
+## Shared state
+
+Each credential **directory** is an isolated account (default `~/.atomicmail`,
+mode `0600` files):
+
+- `credentials.json`
+- `session.jwt`
+- `capability.jwt`
+
+The CLI and MCP read and write the directory you select per command
+(`--credentials-dir` / `credentials_dir`) or the default from
+`ATOMIC_MAIL_CREDENTIALS_DIR`. Multiple accounts = multiple directories; see
+MCP `help` topic `multi_account` or [mcp.md](./mcp.md#multiple-accounts--agents).
+
+## Defaults
+
+- auth endpoint: `https://auth.atomicmail.ai`
+- api endpoint: `https://api.atomicmail.ai`
+- credentials directory: `~/.atomicmail`
+
+## Overriding defaults
+
+- Endpoints: `--auth-url`, `--api-url` or `ATOMIC_MAIL_AUTH_URL`,
+  `ATOMIC_MAIL_API_URL`
+- Credentials path: `--credentials-dir` or `ATOMIC_MAIL_CREDENTIALS_DIR`
+- PoW salt: `--scrypt-salt` or `ATOMIC_MAIL_SCRYPT_SALT`

package/SKILL.md

@@ -0,0 +1,206 @@
+---
+name: atomicmail
+description: Read and write email through the Atomic Mail from an AI agent. Handles proof-of-work authentication and JMAP so the agent thinks in JMAP method calls. Use when the user asks to register an email inbox, list mailboxes, fetch or send email.
+---
+# Atomic Mail
+
+Atomic Mail exposes a programmable inbox over JMAP with PoW signup and JWT
+rotation. This skill ships a single CLI entrypoint with three commands:
+**`register`**, **`jmap_request`**, and **`help`** — matching the MCP server.
+
+## When to use this skill
+
+- Register a new inbox or log in with an existing API key.
+- Send JMAP batches (inline JSON or preset files).
+- Read built-in documentation (JMAP cheatsheet, presets, troubleshooting) or the
+  package README (`atomicmail help --topic readme`).
+
+**Call `atomicmail help` early and often** — before guessing
+placeholders, `using` URNs, or cron setup. Start with `help --topic overview`,
+then `presets` before custom `jmap_request` calls and `cron` after `register`.
+If installed behavior disagrees with docs elsewhere, trust help from the running
+package.
+
+## Commands
+
+```bash
+npx --package=@atomicmail/agent-skill-gh-pages atomicmail register --username "myagent"
+
+npx --package=@atomicmail/agent-skill-gh-pages atomicmail jmap_request --ops-file list_inbox.json
+```
+
+Run **`atomicmail --help`** or **`atomicmail <command> --help`** for flags.
+
+## Defaults
+
+- `authUrl`: `https://auth.atomicmail.ai`
+- `apiUrl`: `https://api.atomicmail.ai`
+- credentials directory: `~/.atomicmail`
+
+## Workflow
+
+### 1. Register (new account)
+
+```bash
+npx --package=@atomicmail/agent-skill-gh-pages atomicmail register \
+  --username "alice"
+```
+
+Writes `credentials.json`, `session.jwt`, `capability.jwt`. Prints JSON
+including `inbox` and `accountId`.
+
+**Required next step:** after register, arrange hourly inbox polling per your
+runtime (see [Hourly inbox polling](#hourly-inbox-polling-after-register)).
+Native cron hosts schedule an **agent** job with `list_inbox.json`; hosts
+without native cron should ask the operator or remind manual fetch. Do not cron
+`atomicmail jmap_request` alone.
+
+Usernames must be 5–21 characters (local-part of your `@atomicmail.ai`
+address).
+
+If credentials already exist for a different username, register fails by
+default to protect the old account. To add another inbox without replacing the
+current one, pass a separate `--credentials-dir` (MCP: `credentials_dir` on
+`register` / `jmap_request`). Use `--forced` only when you intend to replace
+credentials in the **same** directory (after backing it up).
+
+### 2. Register (existing API key, in case losing the credentials file)
+
+```bash
+npx --package=@atomicmail/agent-skill-gh-pages atomicmail register \
+  --api-key "..."
+```
+
+### 3. JMAP request
+
+```bash
+npx --package=@atomicmail/agent-skill-gh-pages atomicmail jmap_request \
+  --ops '[["Mailbox/get", {"accountId": "$ACCOUNT_ID"}, "m0"]]'
+```
+
+`$ACCOUNT_ID`, `$INBOX`, `$INBOX_MAILBOX_ID`, `$UPLOAD_URL`, and `$DOWNLOAD_URL`
+resolve from the session/credentials. Other placeholders such as `$TO` or
+`$SUBJECT` require `--vars` with a JSON object of strings (same substitution
+applies to `--ops` and `--ops-file`).
+
+Preset file:
+
+```bash
+npx --package=@atomicmail/agent-skill-gh-pages atomicmail jmap_request \
+  --ops-file list_inbox.json
+```
+
+With custom placeholders:
+
+```bash
+npx --package=@atomicmail/agent-skill-gh-pages atomicmail jmap_request \
+  --ops-file send_mail.json \
+  --vars '{"TO":"alice@example.com","SUBJECT":"Hello","BODY":"Hi there"}'
+```
+
+Bundled presets (no local file creation required):
+
+- `send_mail.json` (`$TO`, `$SUBJECT`, `$BODY`)
+- `send_mail_attachment.json` (`$TO`, `$SUBJECT`, `$BODY`, `$ATTACHMENT_BASE64`,
+  `$ATTACHMENT_TYPE`, `$ATTACHMENT_NAME`)
+- `send_mail_blob_attachment.json` (`$TO`, `$SUBJECT`, `$BODY`; pair with
+  repeatable **`--attachment PATH`** for RFC 8620 upload →
+  `$ATTACHMENT_0_BLOB_ID`, …)
+- `list_inbox.json` (latest 50; uses `$INBOX_MAILBOX_ID`) — **used for hourly inbox polling**
+- `reply.json` (`$MAIL_ID`, `$BODY`)
+
+## Hourly inbox polling (after register)
+
+Registration only creates credentials. Inbound mail should be fetched and
+triaged about once per hour between interactive sessions.
+
+**Choose the path that matches your runtime — do not mix platforms.**
+
+### If your host supports scheduled jobs
+
+OpenClaw, Hermes, atomic-agent, and similar hosts with native cron: set up an
+hourly **agent** job after the first successful `register`. Wire Atomic Mail MCP
+or AgentSkill into that agent. The scheduled turn should call `list_inbox.json`
+inside the agent prompt.
+
+### If your host does **not** support scheduled jobs
+
+Claude, Pi, Cursor, and other chat agents without a cron API: **do not spend
+tokens trying to work around this** — no wrapper scripts, OS crontab/LaunchAgent
+setup, or scheduling on a different platform.
+
+After register, either **ask your operator** to set up hourly polling on a
+capable host (share the examples below), or **remind your operator** to fetch
+mail manually when needed.
+
+### Forbidden: cross-platform scheduling
+
+Do not register in one runtime and schedule the cron job on another (e.g. Pi
+runs `register`, then creates an OpenClaw cron job).
+
+**Do not** cron `atomicmail jmap_request` alone (no agent). **Do not** use
+headless one-shot CLIs (`claude -p`, `pi -p`, `codex exec`) if you want to
+continue the thread.
+
+### Scheduling examples (capable hosts or operators)
+
+| Your setup | Approach |
+| --- | --- |
+| OpenClaw | `openclaw cron add` with `--announce` |
+| Hermes | `hermes cron create` or `/cron` with `--deliver` |
+| Atomic Bot | Same as OpenClaw or Hermes |
+| atomic-agent | `atomic-agent task create --cron` |
+| No native cron (Claude, Pi, Cursor, …) | Ask operator to schedule on a capable host, or remind manual fetch |
+
+Full options, agent prompt, and operator OS-scheduling notes: `atomicmail help
+--topic cron` or MCP `help` topic `cron`.
+
+### Agent prompt (all workflows)
+
+```text
+Use Atomic Mail to fetch my inbox (MCP jmap_request with ops_file list_inbox.json, or atomicmail jmap_request --ops-file list_inbox.json). Summarize new messages, highlight what needs a reply, and stay available — I may ask you to reply, forward, search, or dig into something important.
+```
+
+### Built-in cron examples
+
+**OpenClaw** — [cron docs](https://docs.openclaw.ai/automation/cron-jobs): isolated
+session, `--announce` for delivery.
+
+**Hermes** — [cron docs](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron):
+`--deliver origin` (or `telegram`, `discord`, `email`, …); not `--no-agent`.
+
+**atomic-agent** — `atomic-agent task create --cron "0 * * * *" --message "<prompt>"`
+
+For operator OS-scheduling patterns on terminal hosts, see `help --topic cron`.
+
+### 4. Help
+
+```bash
+npx --package=@atomicmail/agent-skill-gh-pages atomicmail help
+npx --package=@atomicmail/agent-skill-gh-pages atomicmail help --topic jmap_cheatsheet
+```
+
+## Security
+
+- `credentials.json` holds the API key (mode `0600`). Do not commit it.
+- JWT files are bearer secrets — do not log them.
+
+## Attachments and blobs
+
+Use **`send_mail_attachment.json`** (in-band base64) or **`send_mail_blob_attachment.json`**
+with repeatable **`--attachment PATH`** (RFC 8620 upload — same flow as MCP
+**`attachments`**). Rules, limits, and `Blob/upload` JSON shape:
+**`atomicmail help --topic jmap_cheatsheet`**.
+
+```bash
+npx --package=@atomicmail/agent-skill-gh-pages atomicmail jmap_request \
+  --ops-file send_mail_attachment.json \
+  --vars '{"TO":"you@example.com","SUBJECT":"Hi","BODY":"See file","ATTACHMENT_BASE64":"SGVsbG8=","ATTACHMENT_TYPE":"text/plain","ATTACHMENT_NAME":"note.txt"}'
+```
+
+## Overriding defaults
+
+- Endpoints: `--auth-url`, `--api-url` or `ATOMIC_MAIL_AUTH_URL`,
+  `ATOMIC_MAIL_API_URL`
+- Credentials path: `--credentials-dir` or `ATOMIC_MAIL_CREDENTIALS_DIR`
+- PoW salt: `--scrypt-salt` or `ATOMIC_MAIL_SCRYPT_SALT`

package/esm/_dnt.polyfills.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Based on [import-meta-ponyfill](https://github.com/gaubee/import-meta-ponyfill),
+ * but instead of using npm to install additional dependencies,
+ * this approach manually consolidates cjs/mjs/d.ts into a single file.
+ *
+ * Note that this code might be imported multiple times
+ * (for example, both dnt.test.polyfills.ts and dnt.polyfills.ts contain this code;
+ *  or Node.js might dynamically clear the cache and then force a require).
+ * Therefore, it's important to avoid redundant writes to global objects.
+ * Additionally, consider that commonjs is used alongside esm,
+ * so the two ponyfill functions are stored independently in two separate global objects.
+ */
+import { createRequire } from "node:module";
+import { type URL } from "node:url";
+declare global {
+    interface ImportMeta {
+        /** A string representation of the fully qualified module URL. When the
+         * module is loaded locally, the value will be a file URL (e.g.
+         * `file:///path/module.ts`).
+         *
+         * You can also parse the string as a URL to determine more information about
+         * how the current module was loaded. For example to determine if a module was
+         * local or not:
+         *
+         * ```ts
+         * const url = new URL(import.meta.url);
+         * if (url.protocol === "file:") {
+         *   console.log("this module was loaded locally");
+         * }
+         * ```
+         */
+        url: string;
+        /**
+         * A function that returns resolved specifier as if it would be imported
+         * using `import(specifier)`.
+         *
+         * ```ts
+         * console.log(import.meta.resolve("./foo.js"));
+         * // file:///dev/foo.js
+         * ```
+         *
+         * @param specifier The module specifier to resolve relative to `parent`.
+         * @param parent The absolute parent module URL to resolve from.
+         * @returns The absolute (`file:`) URL string for the resolved module.
+         */
+        resolve(specifier: string, parent?: string | URL | undefined): string;
+        /** A flag that indicates if the current module is the main module that was
+         * called when starting the program under Deno.
+         *
+         * ```ts
+         * if (import.meta.main) {
+         *   // this was loaded as the main module, maybe do some bootstrapping
+         * }
+         * ```
+         */
+        main: boolean;
+        /** The absolute path of the current module.
+         *
+         * This property is only provided for local modules (ie. using `file://` URLs).
+         *
+         * Example:
+         * ```
+         * // Unix
+         * console.log(import.meta.filename); // /home/alice/my_module.ts
+         *
+         * // Windows
+         * console.log(import.meta.filename); // C:\alice\my_module.ts
+         * ```
+         */
+        filename: string;
+        /** The absolute path of the directory containing the current module.
+         *
+         * This property is only provided for local modules (ie. using `file://` URLs).
+         *
+         * * Example:
+         * ```
+         * // Unix
+         * console.log(import.meta.dirname); // /home/alice
+         *
+         * // Windows
+         * console.log(import.meta.dirname); // C:\alice
+         * ```
+         */
+        dirname: string;
+    }
+}
+type NodeRequest = ReturnType<typeof createRequire>;
+type NodeModule = NonNullable<NodeRequest["main"]>;
+interface ImportMetaPonyfillCommonjs {
+    (require: NodeRequest, module: NodeModule): ImportMeta;
+}
+interface ImportMetaPonyfillEsmodule {
+    (importMeta: ImportMeta): ImportMeta;
+}
+interface ImportMetaPonyfill extends ImportMetaPonyfillCommonjs, ImportMetaPonyfillEsmodule {
+}
+export declare let import_meta_ponyfill_commonjs: ImportMetaPonyfillCommonjs;
+export declare let import_meta_ponyfill_esmodule: ImportMetaPonyfillEsmodule;
+export declare let import_meta_ponyfill: ImportMetaPonyfill;
+export {};
+//# sourceMappingURL=_dnt.polyfills.d.ts.map

package/esm/_dnt.polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAgC,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB;;;;;;;;;;;;;;WAcG;QACH,GAAG,EAAE,MAAM,CAAC;QACZ;;;;;;;;;;;;WAYG;QACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,GAAG,MAAM,CAAC;QACtE;;;;;;;;WAQG;QACH,IAAI,EAAE,OAAO,CAAC;QAEd;;;;;;;;;;;;WAYG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;;;;;;;;;;;WAYG;QACH,OAAO,EAAE,MAAM,CAAC;KACjB;CACF;AAED,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,KAAK,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AACnD,UAAU,0BAA0B;IAClC,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;CACxD;AACD,UAAU,0BAA0B;IAClC,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC;CACtC;AACD,UAAU,kBACR,SAAQ,0BAA0B,EAAE,0BAA0B;CAC/D;AAiBD,eAAO,IAAI,6BAA6B,EA2BnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,6BAA6B,EA4DnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,oBAAoB,EAoB1B,kBAAkB,CAAC"}

package/esm/_dnt.polyfills.js

@@ -0,0 +1,127 @@
+/**
+ * Based on [import-meta-ponyfill](https://github.com/gaubee/import-meta-ponyfill),
+ * but instead of using npm to install additional dependencies,
+ * this approach manually consolidates cjs/mjs/d.ts into a single file.
+ *
+ * Note that this code might be imported multiple times
+ * (for example, both dnt.test.polyfills.ts and dnt.polyfills.ts contain this code;
+ *  or Node.js might dynamically clear the cache and then force a require).
+ * Therefore, it's important to avoid redundant writes to global objects.
+ * Additionally, consider that commonjs is used alongside esm,
+ * so the two ponyfill functions are stored independently in two separate global objects.
+ */
+//@ts-ignore
+import { createRequire } from "node:module";
+//@ts-ignore
+import { fileURLToPath, pathToFileURL } from "node:url";
+//@ts-ignore
+import { dirname } from "node:path";
+const defineGlobalPonyfill = (symbolFor, fn) => {
+    if (!Reflect.has(globalThis, Symbol.for(symbolFor))) {
+        Object.defineProperty(globalThis, Symbol.for(symbolFor), {
+            configurable: true,
+            get() {
+                return fn;
+            },
+        });
+    }
+};
+export let import_meta_ponyfill_commonjs = (Reflect.get(globalThis, Symbol.for("import-meta-ponyfill-commonjs")) ??
+    (() => {
+        const moduleImportMetaWM = new WeakMap();
+        return (require, module) => {
+            let importMetaCache = moduleImportMetaWM.get(module);
+            if (importMetaCache == null) {
+                const importMeta = Object.assign(Object.create(null), {
+                    url: pathToFileURL(module.filename).href,
+                    main: require.main == module,
+                    resolve: (specifier, parentURL = importMeta.url) => {
+                        return pathToFileURL((importMeta.url === parentURL
+                            ? require
+                            : createRequire(parentURL))
+                            .resolve(specifier)).href;
+                    },
+                    filename: module.filename,
+                    dirname: module.path,
+                });
+                moduleImportMetaWM.set(module, importMeta);
+                importMetaCache = importMeta;
+            }
+            return importMetaCache;
+        };
+    })());
+defineGlobalPonyfill("import-meta-ponyfill-commonjs", import_meta_ponyfill_commonjs);
+export let import_meta_ponyfill_esmodule = (Reflect.get(globalThis, Symbol.for("import-meta-ponyfill-esmodule")) ??
+    ((importMeta) => {
+        const resolveFunStr = String(importMeta.resolve);
+        const shimWs = new WeakSet();
+        //@ts-ignore
+        const mainUrl = ("file:///" + process.argv[1].replace(/\\/g, "/"))
+            .replace(/\/{3,}/, "///");
+        const commonShim = (importMeta) => {
+            if (typeof importMeta.main !== "boolean") {
+                importMeta.main = importMeta.url === mainUrl;
+            }
+            if (typeof importMeta.filename !== "string") {
+                importMeta.filename = fileURLToPath(importMeta.url);
+                importMeta.dirname = dirname(importMeta.filename);
+            }
+        };
+        if (
+        // v16.2.0+, v14.18.0+: Add support for WHATWG URL object to parentURL parameter.
+        resolveFunStr === "undefined" ||
+            // v20.0.0+, v18.19.0+"" This API now returns a string synchronously instead of a Promise.
+            resolveFunStr.startsWith("async")
+        // enable by --experimental-import-meta-resolve flag
+        ) {
+            import_meta_ponyfill_esmodule = (importMeta) => {
+                if (!shimWs.has(importMeta)) {
+                    shimWs.add(importMeta);
+                    const importMetaUrlRequire = {
+                        url: importMeta.url,
+                        require: createRequire(importMeta.url),
+                    };
+                    importMeta.resolve = function resolve(specifier, parentURL = importMeta.url) {
+                        return pathToFileURL((importMetaUrlRequire.url === parentURL
+                            ? importMetaUrlRequire.require
+                            : createRequire(parentURL)).resolve(specifier)).href;
+                    };
+                    commonShim(importMeta);
+                }
+                return importMeta;
+            };
+        }
+        else {
+            /// native support
+            import_meta_ponyfill_esmodule = (importMeta) => {
+                if (!shimWs.has(importMeta)) {
+                    shimWs.add(importMeta);
+                    commonShim(importMeta);
+                }
+                return importMeta;
+            };
+        }
+        return import_meta_ponyfill_esmodule(importMeta);
+    }));
+defineGlobalPonyfill("import-meta-ponyfill-esmodule", import_meta_ponyfill_esmodule);
+export let import_meta_ponyfill = ((...args) => {
+    const _MODULE = (() => {
+        if (typeof require === "function" && typeof module === "object") {
+            return "commonjs";
+        }
+        else {
+            // eval("typeof import.meta");
+            return "esmodule";
+        }
+    })();
+    if (_MODULE === "commonjs") {
+        //@ts-ignore
+        import_meta_ponyfill = (r, m) => import_meta_ponyfill_commonjs(r, m);
+    }
+    else {
+        //@ts-ignore
+        import_meta_ponyfill = (im) => import_meta_ponyfill_esmodule(im);
+    }
+    //@ts-ignore
+    return import_meta_ponyfill(...args);
+});

package/esm/lib/agent/auth/agent-auth-http.d.ts

@@ -0,0 +1,26 @@
+export declare function fetchChallenge(authUrl: string): Promise<{
+    challengeJWT: string;
+    challenge: string;
+    difficulty: number;
+}>;
+export interface SessionResponse {
+    sessionJWT: string;
+    apiKey?: string;
+}
+export declare function exchangeSession(authUrl: string, body: {
+    challengeJWT: string;
+    powHex: string;
+    nonce: string;
+    apiKey?: string;
+    username?: string;
+}): Promise<SessionResponse>;
+export declare function fetchCapability(authUrl: string, sessionJWT: string): Promise<string>;
+export interface PerformPoWInput {
+    authUrl: string;
+    scryptSalt: string;
+    apiKey?: string;
+    username?: string;
+    onPowProgress?: (nonce: bigint) => void;
+}
+export declare function performPoWAndSession(input: PerformPoWInput): Promise<SessionResponse>;
+//# sourceMappingURL=agent-auth-http.d.ts.map

package/esm/lib/agent/auth/agent-auth-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-auth-http.d.ts","sourceRoot":"","sources":["../../../../src/lib/agent/auth/agent-auth-http.ts"],"names":[],"mappings":"AAKA,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CA8BD;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IACJ,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,eAAe,CAAC,CA8B1B;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,eAAe,CAAC,CAgB1B"}