aoform-toolkit 1.0.3

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on Keep a Changelog and this project follows Semantic Versioning.
+
+## [1.0.0] - 2026-02-22
+
+### Added
+- Initial npm-ready release of `aoform-toolkit`.
+- CLI commands for process config initialization and deployment.
+- TypeScript build output in `dist/` for package distribution.

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 AF (Autonomous Finance)
+
+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,113 @@
+# aoform-toolkit
+
+`aoform-toolkit` is a CLI for deploying AO processes from YAML config files.
+It keeps a local state file and only re-sends source code when content changes.
+
+This project is a fork of AOForm originally developed by [AF (Autonomous Finance)](https://autonomous.finance), maintained independently with custom functionality.
+
+## Install
+
+```bash
+npm install --save-dev aoform-toolkit
+```
+
+Use with `npx`:
+
+```bash
+npx aoform --help
+```
+
+## Quick Start
+
+1. Create a config file:
+
+```bash
+npx aoform init
+```
+
+2. Set wallet JSON:
+
+```bash
+export WALLET_JSON="$(cat ~/.aos.json)"
+```
+
+3. Deploy processes:
+
+```bash
+npx aoform deploy
+```
+
+## CLI Commands
+
+`aoform init`
+- Creates `processes.yaml` in the current directory.
+- Option: `-n, --name <name>` to create a custom YAML filename.
+
+`aoform deploy`
+- Deploys or updates processes from YAML config.
+- Options:
+  - `-f, --file <path>` custom YAML file path.
+  - `-u, --url <url>` custom HyperBEAM node URL.
+  - `-s, --scheduler <scheduler>` custom scheduler.
+
+## Configuration (`processes.yaml`)
+
+Top-level value must be an array of process entries.
+
+```yaml
+- name: My-App-V2
+  file: build/output.lua
+  resetModules: true
+  module: cNlipBptaF9JeFAf4wUmpi43EojNanIBos3EfNrEOWo
+  tags:
+    - name: Process-Type
+      value: My-App
+```
+
+Fields:
+- `name` (required): logical process name used in state tracking.
+- `file` (required): Lua source file path.
+- `resetModules` (optional): unload modules before eval.
+- `module` (optional): AO module id.
+- `tags` (optional): spawn tags as `{ name, value }`.
+
+## Environment Variables
+
+- `WALLET_JSON` (required): wallet JSON string used for signing.
+
+Example:
+
+```bash
+export WALLET_JSON="$(cat ~/.aos.json)"
+```
+
+Alternatively, use a `.env` file:
+
+```bash
+# .env
+WALLET_JSON={"address":"...","privateKey":"..."}
+```
+
+
+## State Files
+
+- Default state file: `state.yaml`
+- With a custom deploy file (for example `-f my-processes.yaml`): `state-my-processes.yaml`
+
+The state file stores process IDs and code hashes so unchanged processes are skipped on future deploys.
+
+## Local Development
+
+```bash
+npm install
+npm run build
+npm run aoform -- --help
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).

package/dist/bin/aoform.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=aoform.d.ts.map

package/dist/bin/aoform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aoform.d.ts","sourceRoot":"","sources":["../../bin/aoform.ts"],"names":[],"mappings":""}

package/dist/bin/aoform.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { run } from '../src/cli/run.js';
+run(process.argv);
+//# sourceMappingURL=aoform.js.map

package/dist/bin/aoform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aoform.js","sourceRoot":"","sources":["../../bin/aoform.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAExC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/src/cli/createProgram.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createProgram(): Command;
+//# sourceMappingURL=createProgram.d.ts.map

package/dist/src/cli/createProgram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createProgram.d.ts","sourceRoot":"","sources":["../../../src/cli/createProgram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,wBAAgB,aAAa,YA4B5B"}

package/dist/src/cli/createProgram.js

@@ -0,0 +1,27 @@
+import { Command } from 'commander';
+export function createProgram() {
+    const program = new Command();
+    program
+        .name('aoform')
+        .description('A tool for managing AO processes ⚙️');
+    program
+        .command('init')
+        .description('Initialize a new processes.yaml file')
+        .option('-n, --name <name>', 'Create <name>.yaml (default: processes.yaml)')
+        .action(async (options) => {
+        const { initCommand } = await import('../commands/init.js');
+        await initCommand(options);
+    });
+    program
+        .command('deploy')
+        .description('Deploy or update processes')
+        .option('-f, --file <path>', 'Specify a custom processes.yaml file')
+        .option('-u, --url <url>', 'Specify a HyperBEAM node URL')
+        .option('-s, --scheduler <scheduler>', 'Specify a scheduler')
+        .action(async (options) => {
+        const { deployCommand } = await import('../commands/deploy.js');
+        await deployCommand(options);
+    });
+    return program;
+}
+//# sourceMappingURL=createProgram.js.map

package/dist/src/cli/createProgram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createProgram.js","sourceRoot":"","sources":["../../../src/cli/createProgram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CAAC,qCAAqC,CAAC,CAAA;IAErD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,sCAAsC,CAAC;SACnD,MAAM,CAAC,mBAAmB,EAAE,8CAA8C,CAAC;SAC3E,MAAM,CAAC,KAAK,EAAE,OAAqB,EAAE,EAAE;QACtC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAC5D,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,mBAAmB,EAAE,sCAAsC,CAAC;SACnE,MAAM,CAAC,iBAAiB,EAAE,8BAA8B,CAAC;SACzD,MAAM,CAAC,6BAA6B,EAAE,qBAAqB,CAAC;SAC5D,MAAM,CAAC,KAAK,EAAE,OAAqB,EAAE,EAAE;QACtC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAChE,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/cli/run.d.ts

@@ -0,0 +1,2 @@
+export declare function run(argv?: string[]): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/src/cli/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/run.ts"],"names":[],"mappings":"AAEA,wBAAsB,GAAG,CAAC,IAAI,WAAe,iBAO5C"}

package/dist/src/cli/run.js

@@ -0,0 +1,11 @@
+import { createProgram } from './createProgram.js';
+export async function run(argv = process.argv) {
+    try {
+        await createProgram().parseAsync(argv);
+    }
+    catch (err) {
+        console.error('CLI execution failed:', err);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/src/cli/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/cli/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI;IAC3C,IAAI,CAAC;QACH,MAAM,aAAa,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;QAC5C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/src/commands/deploy.d.ts

@@ -0,0 +1,3 @@
+import type { OptionValues } from 'commander';
+export declare const deployCommand: (options: OptionValues) => Promise<never>;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/src/commands/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/commands/deploy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,eAAO,MAAM,aAAa,GAAU,SAAS,YAAY,mBASxD,CAAC"}

package/dist/src/commands/deploy.js

@@ -0,0 +1,12 @@
+import { deployProcesses } from '../core/deploy/index.js';
+export const deployCommand = async (options) => {
+    try {
+        await deployProcesses({ file: options.file, url: options.url, scheduler: options.scheduler });
+        process.exit(0);
+    }
+    catch (err) {
+        console.error('Error deploying processes:', err);
+        process.exit(1);
+    }
+};
+//# sourceMappingURL=deploy.js.map

package/dist/src/commands/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../../src/commands/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,OAAqB,EAAE,EAAE;IAE3D,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,EAAC,IAAI,EAAC,OAAO,CAAC,IAA0B,EAAE,GAAG,EAAC,OAAO,CAAC,GAAyB,EAAE,SAAS,EAAC,OAAO,CAAC,SAA+B,EAAC,CAAC,CAAC;QAC3J,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC"}

package/dist/src/commands/init.d.ts

@@ -0,0 +1,3 @@
+import type { OptionValues } from 'commander';
+export declare const initCommand: (options?: OptionValues) => Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/src/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,eAAO,MAAM,WAAW,GAAU,UAAS,YAAiB,kBAiB3D,CAAC"}

package/dist/src/commands/init.js

@@ -0,0 +1,22 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+export const initCommand = async (options = {}) => {
+    const name = options.name?.trim();
+    const fileName = name
+        ? (name.endsWith('.yaml') || name.endsWith('.yml') ? name : `${name}.yaml`)
+        : 'processes.yaml';
+    const configFilePath = path.join(process.cwd(), fileName);
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    const templatePath = path.resolve(__dirname, '../templates/processes.yaml');
+    try {
+        await fs.access(configFilePath);
+        console.log(`${path.basename(configFilePath)} file already exists.`);
+    }
+    catch {
+        const template = await fs.readFile(templatePath, 'utf-8');
+        await fs.writeFile(configFilePath, template, 'utf-8');
+        console.log(`${path.basename(configFilePath)} file created successfully.`);
+    }
+};
+//# sourceMappingURL=init.js.map

package/dist/src/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAGpC,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,UAAwB,EAAE,EAAE,EAAE;IAC9D,MAAM,IAAI,GAAI,OAAO,CAAC,IAA2B,EAAE,IAAI,EAAE,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI;QACnB,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC;QAC3E,CAAC,CAAC,gBAAgB,CAAC;IACrB,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAC;IAE5E,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,6BAA6B,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC,CAAC"}

package/dist/src/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const default_hb_url = "https://push.forward.computer/";
+export declare const scheduler = "n_XZJhUnmldNFo4dhajoPZWhBXuJk-OcQr5JQ49c4Zo";
+export declare const default_scheduler = "n_XZJhUnmldNFo4dhajoPZWhBXuJk-OcQr5JQ49c4Zo";
+export declare const authority = "n_XZJhUnmldNFo4dhajoPZWhBXuJk-OcQr5JQ49c4Zo";
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,mCAAmC,CAAA;AAE9D,eAAO,MAAM,SAAS,gDAAgD,CAAA;AACtE,eAAO,MAAM,iBAAiB,gDAAgD,CAAA;AAC9E,eAAO,MAAM,SAAS,gDAAgD,CAAA"}

package/dist/src/constants.js

@@ -0,0 +1,5 @@
+export const default_hb_url = "https://push.forward.computer/";
+export const scheduler = "n_XZJhUnmldNFo4dhajoPZWhBXuJk-OcQr5JQ49c4Zo";
+export const default_scheduler = "n_XZJhUnmldNFo4dhajoPZWhBXuJk-OcQr5JQ49c4Zo";
+export const authority = "n_XZJhUnmldNFo4dhajoPZWhBXuJk-OcQr5JQ49c4Zo";
+//# sourceMappingURL=constants.js.map

package/dist/src/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,gCAAgC,CAAA;AAE9D,MAAM,CAAC,MAAM,SAAS,GAAG,6CAA6C,CAAA;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,6CAA6C,CAAA;AAC9E,MAAM,CAAC,MAAM,SAAS,GAAG,6CAA6C,CAAA"}

package/dist/src/core/deploy/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const RESET_MODULES_LUA: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/core/deploy/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/core/deploy/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,QAiBtB,CAAC"}

package/dist/src/core/deploy/constants.js

@@ -0,0 +1,19 @@
+export const RESET_MODULES_LUA = `
+INITIAL_MODULES = { ".ao", ".crypto.mac.hmac", "string", ".crypto.cipher.morus", "debug", ".handlers", ".crypto.padding.zero", ".crypto.digest.sha2_256", ".crypto.digest.md2", ".crypto.util.hex", ".default", ".eval", ".crypto.util.bit", ".utils", ".crypto.util.stream", "_G", "json", ".crypto.cipher.norx", ".base64", ".crypto.cipher.aes256", ".crypto.digest.md4", ".crypto.util.queue", ".stringify", ".handlers-utils", ".crypto.cipher.issac", "utf8", ".crypto.cipher.aes", ".dump", ".process", ".crypto.cipher.mode.cfb", "ao", ".pretty", ".crypto.digest.sha1", "coroutine", ".crypto.cipher.aes128", ".crypto.init", ".crypto.digest.sha2_512", ".crypto.cipher.aes192", ".crypto.kdf.pbkdf2", ".crypto.mac.init", ".crypto.digest.init", "package", "table", ".crypto.cipher.mode.ctr", ".crypto.util.array", "bit32", ".crypto.cipher.mode.ecb", ".crypto.kdf.init", ".assignment", ".crypto.cipher.mode.cbc", ".crypto.digest.blake2b", ".crypto.digest.sha3", ".crypto.digest.md5", ".crypto.cipher.mode.ofb", "io", "os", ".chance", ".crypto.util.init", ".crypto.cipher.init", ".boot" }
+
+local function isInitialModule(value)
+    for _, v in pairs(INITIAL_MODULES) do
+        if v == value then
+            return true
+        end
+    end
+    return false
+end
+
+for k, _ in pairs(package.loaded) do
+    if not isInitialModule(k) then
+        package.loaded[k] = nil
+    end
+end
+`.trim();
+//# sourceMappingURL=constants.js.map

package/dist/src/core/deploy/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/core/deploy/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;CAiBhC,CAAC,IAAI,EAAE,CAAC"}

package/dist/src/core/deploy/deploySource.d.ts

@@ -0,0 +1,3 @@
+import type { DeployState, ProcessConfig, ProcessDirectory } from '../../types.js';
+export declare function deploySource(ao: any, processInfo: ProcessConfig, state: DeployState, directory: ProcessDirectory): Promise<void>;
+//# sourceMappingURL=deploySource.d.ts.map

package/dist/src/core/deploy/deploySource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploySource.d.ts","sourceRoot":"","sources":["../../../../src/core/deploy/deploySource.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAMnF,wBAAsB,YAAY,CAChC,EAAE,EAAE,GAAG,EACP,WAAW,EAAE,aAAa,EAC1B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAuDf"}

package/dist/src/core/deploy/deploySource.js

@@ -0,0 +1,53 @@
+import { buildLuaCode } from './luaCode.js';
+import { getStringHash } from './hash.js';
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function deploySource(ao, processInfo, state, directory) {
+    const name = processInfo.name;
+    const processId = directory[name];
+    if (!processId) {
+        throw new Error(`No process ID found for '${name}'.`);
+    }
+    const luaCode = buildLuaCode(processInfo, directory);
+    const currentHash = getStringHash(luaCode);
+    if (state[name]?.hash === currentHash) {
+        console.log(`Process '${name}' is up-to-date.`);
+        return;
+    }
+    let attempts = 0;
+    const maxAttempts = 5;
+    const delay = 30000;
+    console.log('Sending code...');
+    while (attempts < maxAttempts) {
+        try {
+            const messageId = await ao.message({
+                process: processId,
+                data: luaCode,
+                tags: [{ name: 'Action', value: 'Eval' }],
+            });
+            const result = await ao.result({
+                process: processId,
+                message: messageId,
+            });
+            if (result.Error) {
+                throw new Error(`Error on 'eval' action: ${JSON.stringify(result.Error)}`);
+            }
+            console.log(`Successfully sent 'Eval' action for process '${name}'.`);
+            console.log(`view result on Lunar Explorer: https://lunar.ar.io/#/explorer/${processId}`);
+            state[name] = { processId, hash: currentHash };
+            return;
+        }
+        catch (err) {
+            attempts += 1;
+            console.error('error', err);
+            console.log(`Failed to send 'eval' action for process '${name}'. Attempt ${attempts}/${maxAttempts}`);
+            if (attempts === maxAttempts) {
+                throw new Error(`Failed to send 'eval' action for process '${name}' after ${maxAttempts} attempts.`);
+            }
+            console.log(`Retrying in ${delay / 1000} seconds...`);
+            await sleep(delay);
+        }
+    }
+}
+//# sourceMappingURL=deploySource.js.map

package/dist/src/core/deploy/deploySource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploySource.js","sourceRoot":"","sources":["../../../../src/core/deploy/deploySource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,EAAO,EACP,WAA0B,EAC1B,KAAkB,EAClB,SAA2B;IAE3B,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;IAC9B,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAE3C,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,KAAK,WAAW,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,kBAAkB,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,WAAW,GAAG,CAAC,CAAC;IACtB,MAAM,KAAK,GAAG,KAAK,CAAC;IAEpB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC/B,OAAO,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC;gBACjC,OAAO,EAAE,SAAS;gBAClB,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;aAC1C,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC;gBAC7B,OAAO,EAAE,SAAS;gBAClB,OAAO,EAAE,SAAS;aACnB,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC7E,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,gDAAgD,IAAI,IAAI,CAAC,CAAA;YACrE,OAAO,CAAC,GAAG,CAAC,iEAAiE,SAAS,EAAE,CAAC,CAAC;YAE1F,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YAC/C,OAAO;QACT,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,IAAI,CAAC,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,6CAA6C,IAAI,cAAc,QAAQ,IAAI,WAAW,EAAE,CAAC,CAAC;YAEtG,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,6CAA6C,IAAI,WAAW,WAAW,YAAY,CAAC,CAAC;YACvG,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,GAAG,IAAI,aAAa,CAAC,CAAC;YACtD,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/core/deploy/hash.d.ts

@@ -0,0 +1,2 @@
+export declare function getStringHash(sourceText: string): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/src/core/deploy/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../../src/core/deploy/hash.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAIxD"}

package/dist/src/core/deploy/hash.js

@@ -0,0 +1,7 @@
+import crypto from 'crypto';
+export function getStringHash(sourceText) {
+    const hashSum = crypto.createHash('sha256');
+    hashSum.update(sourceText);
+    return hashSum.digest('hex');
+}
+//# sourceMappingURL=hash.js.map

package/dist/src/core/deploy/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../../src/core/deploy/hash.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/src/core/deploy/index.d.ts

@@ -0,0 +1,6 @@
+export declare function deployProcesses({ file, url, scheduler }: {
+    file?: string;
+    url?: string;
+    scheduler?: string;
+}): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/deploy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/deploy/index.ts"],"names":[],"mappings":"AAUA,wBAAsB,eAAe,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAC,EAAE;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAC,iBAgC9G"}

package/dist/src/core/deploy/index.js

@@ -0,0 +1,31 @@
+import dotenv from 'dotenv';
+import { connect, createDataItemSigner } from '@permaweb/aoconnect';
+import { loadProcesses, loadState, saveState } from './io.js';
+import { spawnProcess } from './spawnProcess.js';
+import { deploySource } from './deploySource.js';
+import { default_hb_url, default_scheduler } from '../../constants.js';
+dotenv.config();
+export async function deployProcesses({ file, url, scheduler }) {
+    if (!process.env.WALLET_JSON) {
+        throw new Error('Missing WALLET_JSON environment variable. Please provide wallet JSON in WALLET_JSON.');
+    }
+    const wallet = JSON.parse(process.env.WALLET_JSON);
+    const signer = createDataItemSigner(wallet);
+    const processes = loadProcesses(file);
+    const state = loadState(file);
+    const ao = connect({
+        MODE: "mainnet",
+        SCHEDULER: scheduler || default_scheduler,
+        URL: url || default_hb_url,
+        signer
+    });
+    const directory = {};
+    for (const processInfo of processes) {
+        directory[processInfo.name] = await spawnProcess(ao, processInfo, state, directory);
+    }
+    for (const processInfo of processes) {
+        await deploySource(ao, processInfo, state, directory);
+    }
+    saveState(file, state);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/core/deploy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/deploy/index.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvE,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAoD;IAE7G,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;IAC1G,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAY,CAAC;IAC9D,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAa,CAAC,CAAC;IAEnD,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE9B,MAAM,EAAE,GAAG,OAAO,CAChB;QACE,IAAI,EAAE,SAAS;QACf,SAAS,EAAC,SAAS,IAAI,iBAAiB;QACxC,GAAG,EAAE,GAAG,IAAI,cAAc;QAC1B,MAAM;KACP,CACF,CAAC;IAEF,MAAM,SAAS,GAAqB,EAAE,CAAC;IAEvC,KAAK,MAAM,WAAW,IAAI,SAAS,EAAE,CAAC;QACpC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,MAAM,WAAW,IAAI,SAAS,EAAE,CAAC;QACpC,MAAM,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACxD,CAAC;IAED,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACzB,CAAC"}

package/dist/src/core/deploy/io.d.ts

@@ -0,0 +1,5 @@
+import type { DeployState, ProcessConfig } from '../../types.js';
+export declare function loadProcesses(customFilePath?: string): ProcessConfig[];
+export declare function loadState(customFilePath?: string): DeployState;
+export declare function saveState(customFilePath: string | undefined, state: DeployState): void;
+//# sourceMappingURL=io.d.ts.map

package/dist/src/core/deploy/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../../../src/core/deploy/io.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAOjE,wBAAgB,aAAa,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAiBtE;AAED,wBAAgB,SAAS,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,WAAW,CAa9D;AAED,wBAAgB,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAKtF"}

package/dist/src/core/deploy/io.js

@@ -0,0 +1,47 @@
+import yaml from 'js-yaml';
+import fs from 'fs';
+import path from 'path';
+function getStateFileName(customFilePath) {
+    if (!customFilePath)
+        return 'state.yaml';
+    return `state-${customFilePath}`;
+}
+export function loadProcesses(customFilePath) {
+    const processesYamlPath = path.join(process.cwd(), customFilePath || 'processes.yaml');
+    try {
+        const processesYaml = fs.readFileSync(processesYamlPath, 'utf8');
+        const processes = (yaml.load(processesYaml) || []);
+        if (!Array.isArray(processes)) {
+            throw new Error(`Expected an array in ${processesYamlPath}`);
+        }
+        return processes;
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT') {
+            throw err;
+        }
+        console.warn(`${path.basename(processesYamlPath)} file not found. No processes will be deployed or updated.`);
+        return [];
+    }
+}
+export function loadState(customFilePath) {
+    const stateFile = getStateFileName(customFilePath);
+    const stateYamlPath = path.join(process.cwd(), stateFile);
+    try {
+        const stateYaml = fs.readFileSync(stateYamlPath, 'utf8');
+        return (yaml.load(stateYaml) || {});
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return {};
+        }
+        throw err;
+    }
+}
+export function saveState(customFilePath, state) {
+    const stateFile = getStateFileName(customFilePath);
+    const stateYamlPath = path.join(process.cwd(), stateFile);
+    const updatedState = yaml.dump(state);
+    fs.writeFileSync(stateYamlPath, updatedState, 'utf8');
+}
+//# sourceMappingURL=io.js.map

package/dist/src/core/deploy/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../../../src/core/deploy/io.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,SAAS,gBAAgB,CAAC,cAAuB;IAC/C,IAAI,CAAC,cAAc;QAAE,OAAO,YAAY,CAAC;IACzC,OAAO,SAAS,cAAc,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,cAAuB;IACnD,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,IAAI,gBAAgB,CAAC,CAAC;IAEvF,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAY,CAAC;QAC9D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,wBAAwB,iBAAiB,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,SAA4B,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,4DAA4D,CAAC,CAAC;QAC9G,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,cAAuB;IAC/C,MAAM,SAAS,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC;IACnD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IAE1D,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAgB,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,cAAkC,EAAE,KAAkB;IAC9E,MAAM,SAAS,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC;IACnD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC"}

package/dist/src/core/deploy/luaCode.d.ts

@@ -0,0 +1,3 @@
+import type { ProcessConfig, ProcessDirectory } from '../../types.js';
+export declare function buildLuaCode(processInfo: ProcessConfig, directory: ProcessDirectory): string;
+//# sourceMappingURL=luaCode.d.ts.map

package/dist/src/core/deploy/luaCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"luaCode.d.ts","sourceRoot":"","sources":["../../../../src/core/deploy/luaCode.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAYtE,wBAAgB,YAAY,CAAC,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAU5F"}

package/dist/src/core/deploy/luaCode.js

@@ -0,0 +1,20 @@
+import fs from 'fs';
+import { pack } from '../lua/packLua.js';
+import { RESET_MODULES_LUA } from './constants.js';
+function buildDirectoryCode(directory) {
+    return `
+package.preload["aoform.directory"] = function () return {
+  ${Object.keys(directory).map((key) => `["${key}"] = "${directory[key]}"`).join(',\n')}
+} end
+  `.trim();
+}
+export function buildLuaCode(processInfo, directory) {
+    const filePath = processInfo.file;
+    const prerunFilePath = processInfo.prerun || '';
+    const mainScript = processInfo.pack ? pack(filePath) : fs.readFileSync(filePath, 'utf8');
+    const prerunScript = prerunFilePath ? fs.readFileSync(prerunFilePath, 'utf8') : '';
+    const resetModulesCode = processInfo.resetModules === false ? '' : RESET_MODULES_LUA;
+    const directoryCode = processInfo.directory === true ? buildDirectoryCode(directory) : '';
+    return `${resetModulesCode}\n${directoryCode}\n${prerunScript}\n${mainScript}`;
+}
+//# sourceMappingURL=luaCode.js.map

package/dist/src/core/deploy/luaCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"luaCode.js","sourceRoot":"","sources":["../../../../src/core/deploy/luaCode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKnD,SAAS,kBAAkB,CAAC,SAA2B;IACrD,OAAO;;IAEL,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,SAAS,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;;GAEpF,CAAC,IAAI,EAAE,CAAC;AACX,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,WAA0B,EAAE,SAA2B;IAClF,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC;IAClC,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC;IAEhD,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzF,MAAM,YAAY,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnF,MAAM,gBAAgB,GAAG,WAAW,CAAC,YAAY,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC;IACrF,MAAM,aAAa,GAAG,WAAW,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1F,OAAO,GAAG,gBAAgB,KAAK,aAAa,KAAK,YAAY,KAAK,UAAU,EAAE,CAAC;AACjF,CAAC"}

package/dist/src/core/deploy/spawnProcess.d.ts

@@ -0,0 +1,3 @@
+import type { DeployState, ProcessConfig, ProcessDirectory } from '../../types.js';
+export declare function spawnProcess(ao: any, processInfo: ProcessConfig, state: DeployState, directory: ProcessDirectory): Promise<string>;
+//# sourceMappingURL=spawnProcess.d.ts.map

package/dist/src/core/deploy/spawnProcess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawnProcess.d.ts","sourceRoot":"","sources":["../../../../src/core/deploy/spawnProcess.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAO,MAAM,gBAAgB,CAAC;AAaxF,wBAAsB,YAAY,CAChC,EAAE,EAAE,GAAG,EACP,WAAW,EAAE,aAAa,EAC1B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA4CjB"}

package/dist/src/core/deploy/spawnProcess.js

@@ -0,0 +1,51 @@
+import { scheduler } from '../../constants.js';
+function mapTags(tags, directory) {
+    return (tags || []).map((tag) => {
+        if (!directory[tag.value])
+            return tag;
+        return { ...tag, value: directory[tag.value] };
+    });
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function spawnProcess(ao, processInfo, state, directory) {
+    const name = processInfo.name;
+    const tags = mapTags(processInfo.tags, directory);
+    if (state[name]?.processId) {
+        const existingProcessId = state[name].processId;
+        console.log(`Using existing process ID '${existingProcessId}' for process '${name}'.`);
+        return existingProcessId;
+    }
+    console.log('Spawning process...', {
+        module: processInfo.module,
+        scheduler: processInfo.scheduler,
+        tags,
+    });
+    let spawnAttempts = 0;
+    const maxSpawnAttempts = 5;
+    const spawnDelay = 30000; // 30 seconds
+    while (spawnAttempts < maxSpawnAttempts) {
+        try {
+            const processId = await ao.spawn({
+                module: processInfo.module,
+                scheduler, //: processInfo.scheduler,
+                tags,
+            });
+            console.log('Spawned process:', processId);
+            return processId;
+        }
+        catch (err) {
+            spawnAttempts += 1;
+            console.log('err', err);
+            console.log(`Failed to spawn process '${name}'. Attempt ${spawnAttempts}/${maxSpawnAttempts}`);
+            if (spawnAttempts === maxSpawnAttempts) {
+                throw new Error(`Failed to spawn process '${name}' after ${maxSpawnAttempts} attempts.`);
+            }
+            console.log(`Retrying in ${spawnDelay / 1000} seconds...`);
+            await sleep(spawnDelay);
+        }
+    }
+    throw new Error(`Failed to spawn process '${name}'.`);
+}
+//# sourceMappingURL=spawnProcess.js.map

package/dist/src/core/deploy/spawnProcess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawnProcess.js","sourceRoot":"","sources":["../../../../src/core/deploy/spawnProcess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,SAAS,OAAO,CAAC,IAAuB,EAAE,SAA2B;IACnE,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC9B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QACtC,OAAO,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,EAAO,EACP,WAA0B,EAC1B,KAAkB,EAClB,SAA2B;IAE3B,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;IAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAElD,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;QAC3B,MAAM,iBAAiB,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,8BAA8B,iBAAiB,kBAAkB,IAAI,IAAI,CAAC,CAAC;QACvF,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE;QACjC,MAAM,EAAE,WAAW,CAAC,MAAM;QAC1B,SAAS,EAAE,WAAW,CAAC,SAAS;QAChC,IAAI;KACL,CAAC,CAAC;IAEH,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,MAAM,gBAAgB,GAAG,CAAC,CAAC;IAC3B,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,aAAa;IAEvC,OAAO,aAAa,GAAG,gBAAgB,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC;gBAC/B,MAAM,EAAE,WAAW,CAAC,MAAM;gBAC1B,SAAS,EAAE,0BAA0B;gBACrC,IAAI;aACL,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;YAC3C,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,aAAa,IAAI,CAAC,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,cAAc,aAAa,IAAI,gBAAgB,EAAE,CAAC,CAAC;YAE/F,IAAI,aAAa,KAAK,gBAAgB,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,WAAW,gBAAgB,YAAY,CAAC,CAAC;YAC3F,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,eAAe,UAAU,GAAG,IAAI,aAAa,CAAC,CAAC;YAC3D,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,IAAI,CAAC,CAAC;AACxD,CAAC"}

package/dist/src/core/lua/packLua.d.ts

@@ -0,0 +1,10 @@
+interface LuaModule {
+    name: string;
+    path: string;
+    content?: string;
+}
+export declare function createExecutableFromProject(project: LuaModule[]): [string, LuaModule[]];
+export declare function createProjectStructure(mainFile: string): LuaModule[];
+export declare function pack(startFile: string): string;
+export {};
+//# sourceMappingURL=packLua.d.ts.map

package/dist/src/core/lua/packLua.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packLua.d.ts","sourceRoot":"","sources":["../../../../src/core/lua/packLua.ts"],"names":[],"mappings":"AAGA,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAuBvF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAqBpE;AAiBD,wBAAgB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAI9C"}

package/dist/src/core/lua/packLua.js

@@ -0,0 +1,55 @@
+import path from 'path';
+import fs from 'fs';
+export function createExecutableFromProject(project) {
+    const getModFnName = (name) => name.replace(/\./g, '_').replace(/^_/, '');
+    const contents = [];
+    for (let i = 0; i < project.length - 1; i++) {
+        const mod = project[i];
+        const existing = contents.find((m) => m.path === mod.path);
+        const moduleContent = (!existing && `-- module: "${mod.name}"\nlocal function _loaded_mod_${getModFnName(mod.name)}()\n${mod.content}\nend\n`) || '';
+        const requireMapper = `\n_G.package.loaded["${mod.name}"] = _loaded_mod_${getModFnName(existing?.name || mod.name)}()`;
+        contents.push({
+            ...mod,
+            content: moduleContent + requireMapper,
+        });
+    }
+    contents.push(project[project.length - 1]);
+    return [
+        contents.reduce((acc, con) => acc + '\n\n' + (con.content || ''), ''),
+        contents,
+    ];
+}
+export function createProjectStructure(mainFile) {
+    const sorted = [];
+    const cwd = path.dirname(mainFile);
+    const isSorted = (node) => sorted.find((sortedNode) => sortedNode.path === node.path);
+    function dfs(currentNode) {
+        const unvisitedChildNodes = exploreNodes(currentNode, cwd).filter((node) => !isSorted(node));
+        for (let i = 0; i < unvisitedChildNodes.length; i++) {
+            dfs(unvisitedChildNodes[i]);
+        }
+        if (!isSorted(currentNode)) {
+            sorted.push(currentNode);
+        }
+    }
+    dfs({ name: mainFile, path: mainFile });
+    return sorted.filter((mod) => mod.content !== undefined);
+}
+function exploreNodes(node, cwd) {
+    if (!fs.existsSync(node.path))
+        return [];
+    node.content = fs.readFileSync(node.path, 'utf-8');
+    const requirePattern = /(?<!^.*--.*)(?<=(require( *)(\n*)(\()?( *)("|'))).*(?=("|'))/gm;
+    const requiredModules = node.content.match(requirePattern)?.map((mod) => ({
+        name: mod,
+        path: path.join(cwd, mod.replace(/\./g, '/') + '.lua'),
+        content: undefined,
+    })) || [];
+    return requiredModules;
+}
+export function pack(startFile) {
+    const projectStructure = createProjectStructure(startFile);
+    const [executable] = createExecutableFromProject(projectStructure);
+    return executable;
+}
+//# sourceMappingURL=packLua.js.map

package/dist/src/core/lua/packLua.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packLua.js","sourceRoot":"","sources":["../../../../src/core/lua/packLua.ts"],"names":[],"mappings":"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"}

package/dist/src/templates/processes.yaml

@@ -0,0 +1,11 @@
+# Example processes.yaml file
+#
+# - name: process1
+#   file: path/to/process1.lua
+#   scheduler: scheduler_address
+#   module: module_address
+#   tags:
+#     - name: Tag1
+#       value: Value1
+#     - name: Tag2
+#       value: Value2

package/dist/src/types.d.ts

@@ -0,0 +1,22 @@
+export type Tag = {
+    name: string;
+    value: string;
+};
+export type ProcessConfig = {
+    name: string;
+    file: string;
+    pack?: boolean;
+    prerun?: string;
+    resetModules?: boolean;
+    directory?: boolean;
+    module?: string;
+    scheduler?: string;
+    tags?: Tag[];
+};
+export type ProcessState = {
+    processId: string;
+    hash: string;
+};
+export type DeployState = Record<string, ProcessState>;
+export type ProcessDirectory = Record<string, string>;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;CACd,CAAA;AAED,MAAM,MAAM,YAAY,GAAE;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AACvD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "aoform-toolkit",
+  "version": "1.0.3",
+  "description": "CLI toolkit to deploy and update AO processes from YAML configs",
+  "keywords": [
+    "ao",
+    "arweave",
+    "cli",
+    "deployment",
+    "lua",
+    "hyperBEAM"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/merdikim/aoform.git"
+  },
+  "homepage": "https://github.com/merdikim/aoform#readme",
+  "bugs": {
+    "url": "https://github.com/merdikim/aoform/issues"
+  },
+  "bin": {
+    "aoform": "dist/bin/aoform.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "compile": "tsc -p tsconfig.json",
+    "build": "npm run clean && npm run compile && npm run copy:templates",
+    "copy:templates": "mkdir -p dist/src/templates && cp -R src/templates/. dist/src/templates/",
+    "aoform": "node dist/bin/aoform.js",
+    "start": "npm run build && node dist/bin/aoform.js",
+    "prepublishOnly": "npm run build"
+  },
+  "author": "merdikim",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.18"
+  },
+  "dependencies": {
+    "@permaweb/aoconnect": "^0.0.93",
+    "commander": "^12.0.0",
+    "dotenv": "^16.4.5",
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.19.11",
+    "typescript": "^5.7.2"
+  },
+  "type": "module"
+}