@cogineai/clawpacker 0.1.0 → 0.3.0

package/README.md

@@ -19,7 +19,7 @@ This is **template portability**, not full-instance backup.
 
 ## Status
 
-**Internal alpha.** The current CLI is usable for v1-style experiments, but the package format and UX should still be treated as early-stage.
+**Internal alpha.** The current CLI is usable for early experiments (package format v2), but the format and UX should still be treated as early-stage.
 
 Use it when you want to:
 
@@ -29,21 +29,19 @@ Use it when you want to:
 
 Do **not** treat it as a production-grade backup, archival, or disaster-recovery tool yet.
 
-## What Clawpacker does in v1
+## What Clawpacker does
 
 ### Included
 
-By default, Clawpacker exports the portable workspace files:
+Clawpacker uses a **blacklist model** — it includes all files in the workspace (including subdirectories) except those matching explicit exclusion rules.
 
-- `AGENTS.md`
-- `SOUL.md`
-- `IDENTITY.md`
-- `USER.md`
-- `TOOLS.md`
-- `MEMORY.md`
-- `HEARTBEAT.md` if present
+The following files are recognized as **bootstrap files** and flagged in the manifest:
 
-It also writes package metadata:
+`AGENTS.md`, `SOUL.md`, `IDENTITY.md`, `USER.md`, `TOOLS.md`, `MEMORY.md`, `HEARTBEAT.md`, `BOOTSTRAP.md`
+
+All other workspace files are included as well, preserving directory structure.
+
+The package also contains metadata:
 
 - `manifest.json`
 - `config/agent.json`
@@ -54,27 +52,109 @@ It also writes package metadata:
 
 ### Excluded
 
-Clawpacker intentionally excludes or avoids restoring:
+Clawpacker excludes the following subdirectories if they appear inside the workspace:
+
+- `.git`
+- `.openclaw`
+- `node_modules`
+
+And these file patterns:
 
 - `memory/*.md` daily logs
+
+These rules only apply to contents **within** the scanned workspace directory. The parent `~/.openclaw/` installation and its config files are not part of the workspace scan — OpenClaw config is read separately via `--config` or config discovery.
+
+Beyond file-level exclusions, Clawpacker never exports or restores:
+
 - secrets, auth state, cookies, API keys, credentials
 - session/runtime state
 - channel bindings / routing state
 - globally installed skills or extensions
 - machine-specific absolute-path behavior that is not portable
 
-### Skills model in v1
+### Skills model
 
 Skills are **manifest-only** right now.
 
-That means Clawpacker records detected skill references, but it does not bundle or install skill implementations for you.
+That means Clawpacker records detected skill references (using backtick-quoted references like `` `skill-name` ``), but it does not bundle or install skill implementations for you.
+
+### Runtime layer (optional)
+
+In addition to workspace files, OpenClaw agents often have runtime configuration stored in a separate **agentDir** — things like `settings.json`, prompt templates, themes, and model definitions. Clawpacker can optionally package a portable slice of this runtime layer alongside the workspace.
+
+This is an **optional portability convenience**, not a full backup of the agent runtime directory.
+
+#### The three modes
+
+| Mode | What gets packaged | When to use |
+|------|-------------------|-------------|
+| `none` | Nothing from agentDir | You only need workspace files |
+| `default` | `AGENTS.md`, `settings.json`, `prompts/**`, `themes/**`, `models.json` | Most agent transfers (recommended) |
+| `full` | Everything in `default`, plus `skills/**` and `extensions/**` | When the target instance needs locally installed skills or extensions |
+
+Use `--runtime-mode <mode>` on `inspect` and `export`. When omitted, `inspect` defaults to `default`; `export` skips the runtime layer unless the flag is explicitly provided.
+
+#### What is always excluded
+
+Regardless of mode, Clawpacker never packages these from agentDir:
+
+- `auth.json`, `auth-profiles.json` — authentication state
+- `sessions/**` — session data
+- `.git/**`, `node_modules/**`, `npm/**`, `bin/**` — toolchain artifacts
+- `tools/**`, `caches/**`, `logs/**` — ephemeral runtime state
+- Files with extensions `.log`, `.lock`, `.tmp`, `.bak`, `.swp`, `.pid`
+
+These exclusions exist because auth and session state is inherently non-portable and should be established fresh on the target instance.
+
+#### models.json sanitization
+
+When `models.json` is included, Clawpacker **sanitizes** it before packaging:
+
+- API keys, secrets, and `$secretRef` objects are stripped
+- Secret-bearing HTTP headers are removed
+- Non-sensitive fields (model id, provider, max tokens, temperature) are preserved
+
+If sanitization removes everything useful, the file is excluded entirely and a warning is emitted.
+
+#### settings.json path analysis
+
+Clawpacker analyzes path-like values in `settings.json` and classifies them:
+
+| Classification | Meaning | On import |
+|---------------|---------|-----------|
+| `package-internal-workspace` | Points inside the source workspace | Rewritten to target workspace path |
+| `package-internal-agentDir` | Points inside the source agentDir | Rewritten to target agentDir path |
+| `relative` | Relative path (e.g. `./data`) | Preserved as-is |
+| `external-absolute` | Absolute path outside workspace/agentDir | Preserved (may need manual update) |
+| `host-bound` | Platform-specific path (e.g. `C:\...`, `/proc/...`) | Preserved (warning emitted) |
+
+#### Runtime import behavior
+
+When importing a package that includes a runtime layer:
+
+- **`--target-agent-dir`** specifies where runtime files should be written. If omitted, Clawpacker attempts to resolve it from the target OpenClaw config.
+- If no target agentDir can be resolved, import **blocks** and tells you what is needed.
+- If runtime files already exist at the target agentDir, import **blocks** unless `--force` is passed. Only allowlisted runtime files are overwritten — auth and session files are never written.
+- If a target OpenClaw config is provided, the agent entry is upserted with the agentDir path.
+- `settings.json` paths referencing the source workspace or agentDir are automatically rewritten to the target paths.
+
+Use `--dry-run` to preview the full import plan (including runtime file list, path rewrites, and collision detection) before committing.
+
+#### agentDir resolution
+
+The agentDir is resolved from the OpenClaw config by matching the agent entry that owns the source workspace. This requires:
+
+1. A readable OpenClaw config (via `--config`, `OPENCLAW_CONFIG_PATH`, or `~/.openclaw/openclaw.json`)
+2. An agent entry with an `agentDir` field
+
+If the config is missing or the agent entry has no `agentDir`, the runtime layer is skipped on inspect, and export errors out with a clear message.
 
 ## Install
 
 ### Published package
 
 ```bash
-npm install -g clawpacker
+npm install -g @cogineai/clawpacker
 clawpacker --help
 ```
 
@@ -100,7 +180,7 @@ node dist/cli.js --help
 After building, the CLI exposes four commands:
 
 - `inspect` — analyze a workspace before packaging
-- `export` — write a `.ocpkg/` directory package
+- `export` — write a `.ocpkg/` directory or `.ocpkg.tar.gz` archive
 - `import` — restore a package into a target workspace
 - `validate` — verify an imported workspace target
 
@@ -127,12 +207,22 @@ node dist/cli.js inspect \
   --workspace ./tests/fixtures/source-workspace
 ```
 
+With runtime layer inspection:
+
+```bash
+node dist/cli.js inspect \
+  --workspace ./tests/fixtures/source-workspace \
+  --config ./tests/fixtures/openclaw-config/source-config.jsonc \
+  --runtime-mode default
+```
+
 Machine-readable JSON report:
 
 ```bash
 node dist/cli.js inspect \
   --workspace ./tests/fixtures/source-workspace \
   --config ./tests/fixtures/openclaw-config/source-config.jsonc \
+  --runtime-mode default \
   --json
 ```
 
@@ -143,45 +233,101 @@ What `inspect` tells you:
 - whether a portable agent definition could be derived
 - which fields are portable vs import-time inputs
 - which skills were detected
-- v1 warnings you should expect on export/import
+- runtime layer contents (when `--runtime-mode` is `default` or `full`)
+- warnings you should expect on export/import
 
 ### 2) Export a package
 
+Directory package (workspace only):
+
+```bash
+node dist/cli.js export \
+  --workspace ./tests/fixtures/source-workspace \
+  --out ./tests/tmp/example-supercoder.ocpkg \
+  --name supercoder-template \
+  --runtime-mode none
+```
+
+Directory package with runtime layer:
+
+```bash
+node dist/cli.js export \
+  --workspace ./tests/fixtures/source-workspace \
+  --config ./tests/fixtures/openclaw-config/source-config.jsonc \
+  --out ./tests/tmp/example-supercoder.ocpkg \
+  --name supercoder-template \
+  --runtime-mode default
+```
+
+Single-file archive:
+
 ```bash
 node dist/cli.js export \
   --workspace ./tests/fixtures/source-workspace \
   --config ./tests/fixtures/openclaw-config/source-config.jsonc \
   --out ./tests/tmp/example-supercoder.ocpkg \
-  --name supercoder-template
+  --name supercoder-template \
+  --runtime-mode default \
+  --archive
 ```
 
-Current output is JSON, for example:
+The `--archive` flag produces a `.ocpkg.tar.gz` file for easier transport.
+
+Output defaults to human-readable text. Add `--json` for machine-readable output:
 
 ```json
 {
   "status": "ok",
   "packageRoot": ".../example-supercoder.ocpkg",
   "manifestPath": ".../example-supercoder.ocpkg/manifest.json",
-  "fileCount": 12
+  "fileCount": 12,
+  "runtimeMode": "default",
+  "runtimeFiles": ["AGENTS.md", "settings.json", "prompts/system.md"]
 }
 ```
 
 ### 3) Import a package
 
+Accepts both `.ocpkg/` directories and `.ocpkg.tar.gz` archives:
+
+```bash
+node dist/cli.js import \
+  ./tests/tmp/example-supercoder.ocpkg \
+  --target-workspace ./tests/tmp/workspace-supercoder-imported \
+  --agent-id supercoder-imported \
+  --config ./tests/tmp/target-openclaw-config.json
+```
+
+Import with runtime layer targeting a specific agentDir:
+
 ```bash
 node dist/cli.js import \
   ./tests/tmp/example-supercoder.ocpkg \
   --target-workspace ./tests/tmp/workspace-supercoder-imported \
   --agent-id supercoder-imported \
+  --target-agent-dir ~/.openclaw/agents/supercoder-imported \
   --config ./tests/tmp/target-openclaw-config.json
 ```
 
+Preview the import plan without writing anything:
+
+```bash
+node dist/cli.js import \
+  ./tests/tmp/example-supercoder.ocpkg \
+  --target-workspace ./tests/tmp/workspace-supercoder-imported \
+  --agent-id supercoder-imported \
+  --dry-run
+```
+
 Notes:
 
 - `--target-workspace` is required
 - `--agent-id` is strongly recommended and becomes required in practice for collision-safe import planning
+- `--target-agent-dir` is required when the package includes a runtime layer and no agentDir is discoverable from the target config
+- `--dry-run` prints the import plan (including runtime details, path rewrites, and collision info) and exits without writing files
 - if the target workspace or target agent already exists, import blocks unless you pass `--force`
-- if no config is found, import can still restore workspace files, but config registration becomes limited
+- if runtime files already exist at the target agentDir, import blocks unless `--force` is passed; auth and session files are never written even with `--force`
+- if no config is found, import can still restore workspace files, but config registration and runtime import become limited
 
 ### 4) Validate the imported result
 
@@ -192,12 +338,24 @@ node dist/cli.js validate \
   --config ./tests/tmp/target-openclaw-config.json
 ```
 
-Current output is a JSON validation report with:
+When a runtime layer was imported, validate also checks runtime file integrity:
 
-- `passed`
-- `warnings`
-- `failed`
-- `nextSteps`
+```bash
+node dist/cli.js validate \
+  --target-workspace ./tests/tmp/workspace-supercoder-imported \
+  --agent-id supercoder-imported \
+  --target-agent-dir ~/.openclaw/agents/supercoder-imported \
+  --config ./tests/tmp/target-openclaw-config.json
+```
+
+The `--target-agent-dir` flag can be omitted — validate auto-infers it from import metadata when available.
+
+Output defaults to human-readable text. Add `--json` for a structured report with:
+
+- `passed` — checks that succeeded (including runtime file presence and agentDir consistency)
+- `warnings` — non-blocking observations (e.g. auth files found at agentDir)
+- `failed` — checks that failed (e.g. missing runtime files, agentDir mismatch)
+- `nextSteps` — recommended actions
 
 ## OpenClaw config awareness
 
@@ -212,24 +370,23 @@ When you provide `--config`, or when import can discover a nearby OpenClaw confi
 
 ### Config discovery behavior
 
-If you do not pass `--config`, Clawpacker looks for a config in these places:
+Config is resolved in this order:
 
-- `./openclaw-config.json`
-- `./openclaw-config.jsonc`
-- `~/.openclaw/config.json`
-- `~/.openclaw/config.jsonc`
+1. explicit `--config` flag
+2. `OPENCLAW_CONFIG_PATH` environment variable
+3. `~/.openclaw/openclaw.json` (default)
 
 ### Portable config philosophy
 
 Clawpacker does **not** export raw OpenClaw config wholesale.
 
-Instead, it extracts a minimal, portable slice, such as:
+Instead, it extracts a portable slice of agent config, including:
 
-- suggested agent id
-- suggested display name
+- agent id and display name
 - workspace basename suggestion
 - identity name
 - default model, when present
+- tools, skills, heartbeat, sandbox, and runtime settings
 
 And it explicitly excludes things like:
 
@@ -243,17 +400,23 @@ Clawpacker is designed to be conservative.
 
 ### Export safety
 
-- only known portable workspace files are copied
-- daily memory logs are excluded by default
+- all workspace files are included except explicitly excluded directories and patterns
+- daily memory logs (`memory/*.md`) are excluded by default
 - package contents are declared in a manifest instead of hidden in opaque state
 - checksums are generated for integrity verification
+- runtime layer is opt-in via `--runtime-mode`
+- `models.json` is sanitized before packaging — API keys, secrets, and `$secretRef` objects are removed
+- auth and session files are never included in the runtime layer regardless of mode
 
 ### Import safety
 
 - import is planned before it executes
 - existing workspace collisions block by default
 - existing config agent collisions block by default
-- `--force` is required to overwrite existing targets
+- existing runtime file collisions block by default
+- `--force` is required to overwrite existing targets (workspace and runtime files)
+- `--force` never writes auth or session files — these are always excluded
+- `settings.json` paths referencing the source workspace or agentDir are automatically rewritten to the target paths
 - import writes local metadata so validation can confirm what happened later
 
 ### Post-import safety expectations
@@ -267,7 +430,7 @@ Even after a successful import, you should still:
 
 ## Package structure
 
-A typical v1 package looks like this:
+A typical package looks like this:
 
 ```text
 supercoder-template.ocpkg/
@@ -280,6 +443,9 @@ supercoder-template.ocpkg/
     TOOLS.md
     MEMORY.md
     HEARTBEAT.md
+    custom-prompts/
+      review.md
+    ...                     # any other workspace files
   config/
     agent.json
     import-hints.json
@@ -287,36 +453,52 @@ supercoder-template.ocpkg/
   meta/
     checksums.json
     export-report.json
+  runtime/                  # present when --runtime-mode is default or full
+    manifest.json
+    checksums.json
+    path-rewrites.json
+    settings-analysis.json  # present when settings.json was included
+    files/
+      AGENTS.md
+      settings.json
+      models.json           # sanitized — no API keys or secrets
+      prompts/
+        system.md
+      themes/
+        dark.json
+      skills/               # present only in full mode
+        my-skill/
+          SKILL.md
 ```
 
-## What is intentionally out of scope in v1
+The `workspace/` directory mirrors the source workspace structure. All non-excluded files are included, so the contents vary depending on what lives in the source workspace.
+
+The `runtime/` subtree is only present when `--runtime-mode default` or `--runtime-mode full` is used on export. Its `manifest.json` records the mode, source agentDir, and which files were included or excluded. The `files/` subdirectory contains the actual runtime files.
+
+Packages can also be distributed as single-file `.ocpkg.tar.gz` archives.
+
+## What is intentionally out of scope
 
-- full OpenClaw instance backup
-- secret migration
-- auth/session migration
+- full OpenClaw instance backup (the runtime layer is a portable slice, not a full agentDir copy)
+- secret migration (API keys and auth tokens are stripped on export)
+- auth/session migration (auth files are always excluded)
 - channel binding export/import
-- packaging globally installed skill implementations
-- archive transport formats beyond the current directory package flow
 - zero-touch import across mismatched environments
 
 ## Roadmap / known limitations
 
 Near-term likely improvements:
 
-- publishable npm package + stable binary release
-- friendlier non-JSON output for `export`, `import`, and `validate`
-- optional archive packaging for transport
 - richer import guidance when models or skills are missing
-- optional packaging for workspace-local skill folders
 - better package compatibility/version negotiation
 
 Current limitations to be aware of:
 
-- package format should still be treated as alpha
-- skills are detected, but not bundled
+- package format should still be treated as early-stage (currently v2)
+- skills are detected and optionally bundled via `--runtime-mode full`, but not auto-installed on import
 - import assumes conservative file-level replacement semantics via `--force`
 - OpenClaw config support is minimal by design
-- examples currently assume local source usage, not a published global install
+- runtime layer path rewriting only handles `settings.json` — other config files with embedded paths require manual update
 
 ## Development
 
@@ -351,7 +533,7 @@ A practical smoke path is:
 ```bash
 npm run build
 node dist/cli.js inspect --workspace ./tests/fixtures/source-workspace --json
-node dist/cli.js export --workspace ./tests/fixtures/source-workspace --out ./tests/tmp/readme-demo.ocpkg
+node dist/cli.js export --workspace ./tests/fixtures/source-workspace --out ./tests/tmp/readme-demo.ocpkg --runtime-mode none
 node dist/cli.js import ./tests/tmp/readme-demo.ocpkg --target-workspace ./tests/tmp/readme-demo-target --agent-id readme-demo
 node dist/cli.js validate --target-workspace ./tests/tmp/readme-demo-target --agent-id readme-demo
 npm test
@@ -359,7 +541,7 @@ npm test
 
 ## Naming
 
-The npm package name is **`clawpacker`** while the GitHub repository remains **`cogine-ai/clawpack`**.
+The npm package name is **`@cogineai/clawpacker`** while the GitHub repository remains **`cogine-ai/clawpack`**.
 
 Why this naming split:
 

package/dist/cli.js

@@ -6,17 +6,26 @@ const export_1 = require("./commands/export");
 const import_1 = require("./commands/import");
 const inspect_1 = require("./commands/inspect");
 const validate_1 = require("./commands/validate");
+const renderable_cli_error_1 = require("./renderable-cli-error");
 const program = new commander_1.Command();
 program
     .name('clawpacker')
-    .description('Export, import, and validate portable OpenClaw agent/workspace templates.')
-    .version('0.1.0');
+    .description('Export, import, and validate portable OpenClaw agent/workspace templates.\n\nSupports an optional runtime layer (--runtime-mode) that packages agent-level\nconfig from the OpenClaw agentDir alongside workspace files.')
+    .version('0.3.0');
 (0, inspect_1.registerInspectCommand)(program.command('inspect'));
 (0, export_1.registerExportCommand)(program.command('export'));
 (0, import_1.registerImportCommand)(program.command('import'));
 (0, validate_1.registerValidateCommand)(program.command('validate'));
 program.parseAsync(process.argv).catch((error) => {
-    console.error(error);
+    if ((0, renderable_cli_error_1.isRenderableCliError)(error)) {
+        console.error(error.render());
+    }
+    else if (error instanceof Error) {
+        console.error(error.message);
+    }
+    else {
+        console.error(String(error));
+    }
     process.exitCode = 1;
 });
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,8CAA0D;AAC1D,8CAA0D;AAC1D,gDAA4D;AAC5D,kDAA8D;AAE9D,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,2EAA2E,CAAC;KACxF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,IAAA,gCAAsB,EAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AACnD,IAAA,8BAAqB,EAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjD,IAAA,8BAAqB,EAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjD,IAAA,kCAAuB,EAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;AAErD,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,8CAA0D;AAC1D,8CAA0D;AAC1D,gDAA4D;AAC5D,kDAA8D;AAC9D,iEAA8D;AAE9D,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,0NAA0N,CAAC;KACvO,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,IAAA,gCAAsB,EAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AACnD,IAAA,8BAAqB,EAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjD,IAAA,8BAAqB,EAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjD,IAAA,kCAAuB,EAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;AAErD,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxD,IAAI,IAAA,2CAAoB,EAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAChC,CAAC;SAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/commands/export.d.ts

@@ -5,6 +5,9 @@ interface ExportOptions {
     name?: string;
     config?: string;
     agentId?: string;
+    archive?: boolean;
+    json?: boolean;
+    runtimeMode?: string;
 }
 export declare function runExport(options: ExportOptions): Promise<void>;
 export declare function registerExportCommand(command: Command): void;

package/dist/commands/export.js

@@ -7,42 +7,92 @@ exports.runExport = runExport;
 exports.registerExportCommand = registerExportCommand;
 const node_path_1 = __importDefault(require("node:path"));
 const agent_extract_1 = require("../core/agent-extract");
+const openclaw_config_1 = require("../core/openclaw-config");
 const package_write_1 = require("../core/package-write");
+const runtime_mode_1 = require("../core/runtime-mode");
+const runtime_scan_1 = require("../core/runtime-scan");
 const skills_detect_1 = require("../core/skills-detect");
 const workspace_scan_1 = require("../core/workspace-scan");
 async function runExport(options) {
     if (!options.workspace || !options.out) {
         throw new Error('export requires --workspace <path> and --out <path>');
     }
+    const runtimeMode = (0, runtime_mode_1.normalizeRuntimeMode)(options.runtimeMode);
     const scan = await (0, workspace_scan_1.scanWorkspace)(node_path_1.default.resolve(options.workspace));
     const skills = await (0, skills_detect_1.detectSkills)(scan);
     const agentDefinition = await (0, agent_extract_1.extractAgentDefinition)(scan.workspacePath, {
         configPath: options.config,
         agentId: options.agentId,
     });
-    const packageName = options.name ?? node_path_1.default.basename(options.out).replace(/\.ocpkg$/, '');
-    const result = await (0, package_write_1.writePackageDirectory)({
+    const openclawVersion = await (0, openclaw_config_1.detectOpenClawVersion)({
+        configPath: options.config,
+        cwd: scan.workspacePath,
+    });
+    const packageName = options.name ?? node_path_1.default.basename(options.out).replace(/\.ocpkg(\.tar\.gz)?$/, '');
+    let runtimeScan;
+    if (runtimeMode && runtimeMode !== 'none') {
+        const agentDir = await (0, openclaw_config_1.resolveAgentDir)({
+            configPath: options.config,
+            workspacePath: scan.workspacePath,
+            agentId: options.agentId,
+        });
+        if (!agentDir) {
+            throw new Error('Cannot export runtime layer: agentDir could not be resolved from OpenClaw config. ' +
+                'Ensure the agent entry includes an agentDir field, or use --runtime-mode none.');
+        }
+        runtimeScan = await (0, runtime_scan_1.scanRuntime)({
+            mode: runtimeMode,
+            agentDir,
+            workspacePath: scan.workspacePath,
+        });
+    }
+    const writeParams = {
         outputPath: node_path_1.default.resolve(options.out),
         packageName,
         scan,
         skills,
         agentDefinition,
-    });
-    console.log(JSON.stringify({
+        openclawVersion,
+        runtimeScan,
+    };
+    const result = options.archive
+        ? await (0, package_write_1.writePackageArchive)(writeParams)
+        : await (0, package_write_1.writePackageDirectory)(writeParams);
+    const report = {
         status: 'ok',
         packageRoot: result.packageRoot,
         manifestPath: result.manifestPath,
         fileCount: result.fileCount,
-    }, null, 2));
+        runtimeMode: runtimeScan?.mode,
+        runtimeFiles: runtimeScan?.includedFiles.map(f => f.relativePath),
+    };
+    if (options.json) {
+        console.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    const lines = [
+        'Export complete',
+        `  Package: ${report.packageRoot}`,
+        `  Manifest: ${report.manifestPath}`,
+        `  Files: ${report.fileCount}`,
+    ];
+    if (runtimeScan && runtimeScan.mode !== 'none') {
+        lines.push(`  Runtime mode: ${runtimeScan.mode}`);
+        lines.push(`  Runtime files: ${runtimeScan.includedFiles.length}`);
+    }
+    console.log(lines.join('\n'));
 }
 function registerExportCommand(command) {
     command
-        .description('Export a portable .ocpkg directory from a workspace.')
+        .description('Export a portable .ocpkg directory or .ocpkg.tar.gz archive from a workspace.')
         .requiredOption('--workspace <path>', 'Source workspace path')
-        .requiredOption('--out <path>', 'Output package directory path')
+        .requiredOption('--out <path>', 'Output package path')
         .option('--name <package-name>', 'Package name override')
         .option('--config <path>', 'OpenClaw config path')
         .option('--agent-id <id>', 'Source agent id override')
+        .option('--runtime-mode <mode>', 'Runtime layer mode: none (skip), default (settings, prompts, themes, models), or full (adds skills, extensions). Requires a resolvable agentDir in OpenClaw config. Auth and session files are always excluded.')
+        .option('--archive', 'Produce a .ocpkg.tar.gz single-file archive')
+        .option('--json', 'Emit the full machine-readable JSON report')
         .action(runExport);
 }
 //# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

@@ -1 +1 @@
-{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":";;;;;AAeA,8BAiCC;AAED,sDASC;AA3DD,0DAA6B;AAE7B,yDAA+D;AAC/D,yDAA8D;AAC9D,yDAAqD;AACrD,2DAAuD;AAUhD,KAAK,UAAU,SAAS,CAAC,OAAsB;IACpD,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,IAAA,8BAAa,EAAC,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,IAAA,4BAAY,EAAC,IAAI,CAAC,CAAC;IACxC,MAAM,eAAe,GAAG,MAAM,IAAA,sCAAsB,EAAC,IAAI,CAAC,aAAa,EAAE;QACvE,UAAU,EAAE,OAAO,CAAC,MAAM;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,IAAI,mBAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAEvF,MAAM,MAAM,GAAG,MAAM,IAAA,qCAAqB,EAAC;QACzC,UAAU,EAAE,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;QACrC,WAAW;QACX,IAAI;QACJ,MAAM;QACN,eAAe;KAChB,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;QACE,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;AACJ,CAAC;AAED,SAAgB,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,WAAW,CAAC,sDAAsD,CAAC;SACnE,cAAc,CAAC,oBAAoB,EAAE,uBAAuB,CAAC;SAC7D,cAAc,CAAC,cAAc,EAAE,+BAA+B,CAAC;SAC/D,MAAM,CAAC,uBAAuB,EAAE,uBAAuB,CAAC;SACxD,MAAM,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;SACjD,MAAM,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;SACrD,MAAM,CAAC,SAAS,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"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"}

package/dist/commands/import.d.ts

@@ -2,8 +2,11 @@ import type { Command } from 'commander';
 interface ImportOptions {
     targetWorkspace: string;
     agentId?: string;
+    targetAgentDir?: string;
     config?: string;
     force?: boolean;
+    json?: boolean;
+    dryRun?: boolean;
 }
 export declare function runImport(packagePath: string, options: ImportOptions): Promise<void>;
 export declare function registerImportCommand(command: Command): void;