openclaw-castroom 0.1.0

package/README.md

@@ -0,0 +1,96 @@
+# openclaw castroom
+
+Give your OpenClaw agents personality. Pick a series, pick a character, and spawn an agent with that persona baked in.
+
+## What it does
+
+Castroom creates OpenClaw agents pre-loaded with character personas from TV shows. It writes three markdown files into the agent workspace:
+
+- `BOOTSTRAP.md` — initialization instructions
+- `IDENTITY.md` — character identity and traits
+- `SOUL.md` — deeper personality and behavioral patterns
+
+## Setup
+
+```bash
+npm install
+npm run build
+npm link  # optional, for global access
+```
+
+Requires Node.js 18+ and OpenClaw CLI on your PATH.
+
+Run locally without linking:
+
+```bash
+npx . --help
+```
+
+## Usage
+
+### Create an agent with a character persona
+
+```bash
+castroom add <agent-name> --pack <series> --persona <character>
+```
+
+**Examples:**
+
+```bash
+# The Office
+castroom add michael --pack office --persona michael
+castroom add assistant --pack office --persona dwight
+
+# Trailer Park Boys
+castroom add ricky --pack trailer-park-boys --persona ricky
+```
+
+If `--pack` is omitted, defaults to `office`. If `--persona` is omitted, uses the agent name.
+
+```bash
+# Creates agent "dwight" with dwight persona from office pack
+castroom add dwight
+```
+
+### Populate an existing workspace
+
+If you already have an OpenClaw workspace and just want to inject a persona:
+
+```bash
+castroom populate --workspace /path/to/workspace --pack <series> --persona <character>
+```
+
+### List available options
+
+```bash
+castroom --list-packs                         # Show all series
+castroom --pack office --list-personas        # Show office characters
+castroom --pack trailer-park-boys --list-personas
+```
+
+## Available Packs
+
+### office (The Office)
+
+michael, dwight, jim, pam, kelly, creed, kevin, angela, oscar, stanley, phyllis, andy, erin, ryan, toby, gabe, meredith, karen, jan, david-wallace, darryl, roy, carol
+
+### trailer-park-boys (Trailer Park Boys)
+
+ricky, julian, bubbles, lahey, randy, cory, trevor, sarah, ray, lucy, tyrone, jroc, trinity, sam, barbara, george, cyrus
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `--pack <name>` | Series/pack to use (default: `office`) |
+| `--persona <name>` | Character persona (default: agent name) |
+| `--workspace <path>` | Override workspace path |
+| `--force` | Overwrite existing persona files |
+| `--dry-run` | Preview without writing files |
+
+## Adding a new pack
+
+1. Create `src/personas/packs/<pack-name>/`
+2. Add character `.ts` files and an `index.ts` exporting the persona map
+3. Register the pack in `src/personas/index.ts`
+4. Rebuild with `npm run build`

package/dist/commands/add.js

@@ -0,0 +1,92 @@
+import { populateWorkspace } from './populate.js';
+import { findPersonaInAnyPack, getPersona, listPacks, listPersonas, } from '../personas/index.js';
+import { detectNonInteractiveFlags, ensureOpenclawAvailable, getOpenclawAddHelp, runOpenclawCommand, } from '../openclaw/runner.js';
+import { resolveWorkspace } from '../openclaw/workspace.js';
+import { withSpinner } from '../ui/spinner.js';
+export const addCommand = async (agentName, options) => {
+    if (options.listPacks) {
+        console.log(listPacks().join('\n'));
+        return;
+    }
+    const pack = options.pack ?? 'office';
+    if (options.listPersonas || options.packListPersonas) {
+        console.log(listPersonas(pack).join('\n'));
+        return;
+    }
+    if (!agentName) {
+        throw new Error('Agent name is required unless --list-packs or --list-personas is used.');
+    }
+    if (options.interactive && options.nonInteractive) {
+        throw new Error('Use either --interactive or --non-interactive, not both.');
+    }
+    const personaInput = options.persona ?? agentName;
+    let persona;
+    try {
+        persona = getPersona(pack, personaInput);
+    }
+    catch {
+        const found = findPersonaInAnyPack(personaInput);
+        if (found) {
+            persona = found.persona;
+        }
+        else {
+            throw new Error(`Unknown persona "${personaInput}". Use --pack <series> to specify, or run --list-personas to see options.`);
+        }
+    }
+    await ensureOpenclawAvailable();
+    let nonInteractiveFlags = [];
+    if (options.nonInteractive) {
+        const helpText = await getOpenclawAddHelp();
+        nonInteractiveFlags = detectNonInteractiveFlags(helpText);
+        if (nonInteractiveFlags.length === 0) {
+            throw new Error('OpenClaw does not expose a non-interactive flag. Re-run with --interactive or create the agent manually and use populate with --workspace.');
+        }
+    }
+    const args = ['agents', 'add', agentName, ...nonInteractiveFlags];
+    if (options.verbose) {
+        console.log(`running: openclaw ${args.join(' ')}`);
+    }
+    const result = await runOpenclawCommand(args, {
+        streamOutput: Boolean(options.verbose || !options.nonInteractive),
+        stdin: 'inherit',
+    });
+    if (result.exitCode !== 0) {
+        throw new Error(`OpenClaw failed with exit code ${result.exitCode}. Check the OpenClaw output and try again.`);
+    }
+    const resolution = await resolveWorkspace({
+        explicitPath: options.workspace,
+        output: result,
+        cwd: process.cwd(),
+    });
+    for (const warning of resolution.warnings) {
+        console.warn(`warning: ${warning}`);
+    }
+    if (options.verbose) {
+        console.log(`workspace: ${resolution.workspace} (source: ${resolution.source})`);
+    }
+    const pickRandom = (arr) => arr[Math.floor(Math.random() * arr.length)] ?? '';
+    const injection = await withSpinner(options.dryRun ? 'Previewing persona injection…' : 'Injecting persona…', async () => populateWorkspace({
+        workspacePath: resolution.workspace,
+        persona,
+        force: options.force ?? true,
+        dryRun: options.dryRun,
+    }), {
+        enabled: Boolean(process.stdout.isTTY) && !options.verbose,
+        successText: options.dryRun ? 'Preview ready' : 'Persona ready',
+        failureText: 'Persona injection failed',
+    });
+    const wrote = injection.written.length;
+    const skipped = injection.skipped.length;
+    if (options.dryRun) {
+        console.log(`Would write ${wrote} file(s) (${skipped} skipped).`);
+    }
+    else {
+        console.log(`Injected persona files (${wrote} written, ${skipped} skipped).`);
+    }
+    const greetings = persona.startAgentGreetings?.length ? persona.startAgentGreetings : persona.bootstrapGreetings;
+    const line = pickRandom(greetings);
+    if (line) {
+        console.log(`\n${persona.name}: ${line}`);
+    }
+};
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

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

package/dist/commands/populate.js

@@ -0,0 +1,80 @@
+import fsExtra from 'fs-extra';
+const { ensureDir, pathExists, remove, rename, stat, writeFile } = fsExtra;
+import { basename, dirname, join } from 'pathe';
+import { renderPersonaFiles } from '../templates/common.js';
+import { withSpinner } from '../ui/spinner.js';
+const atomicWriteFile = async (filePath, content) => {
+    await ensureDir(dirname(filePath));
+    const tempPath = join(dirname(filePath), `.${basename(filePath)}.${Date.now()}.tmp`);
+    await writeFile(tempPath, content, { encoding: 'utf8' });
+    try {
+        await rename(tempPath, filePath);
+    }
+    catch (error) {
+        if (process.platform === 'win32') {
+            await remove(filePath);
+            await rename(tempPath, filePath);
+            return;
+        }
+        throw error;
+    }
+};
+const assertWorkspaceDir = async (workspacePath) => {
+    if (!(await pathExists(workspacePath))) {
+        throw new Error(`Workspace not found: ${workspacePath}`);
+    }
+    const stats = await stat(workspacePath);
+    if (!stats.isDirectory()) {
+        throw new Error(`Workspace is not a directory: ${workspacePath}`);
+    }
+};
+export const populateWorkspace = async (options) => {
+    await assertWorkspaceDir(options.workspacePath);
+    const files = renderPersonaFiles(options.persona);
+    const written = [];
+    const skipped = [];
+    for (const [fileName, content] of Object.entries(files)) {
+        const filePath = join(options.workspacePath, fileName);
+        const exists = await pathExists(filePath);
+        if (exists && !options.force) {
+            skipped.push(filePath);
+            continue;
+        }
+        if (options.dryRun) {
+            written.push(filePath);
+            continue;
+        }
+        await atomicWriteFile(filePath, content);
+        written.push(filePath);
+    }
+    return { written, skipped };
+};
+export const populateCommand = async (options) => {
+    const pickRandom = (arr) => arr[Math.floor(Math.random() * arr.length)] ?? '';
+    const result = await withSpinner(options.dryRun ? 'Previewing persona injection…' : 'Injecting persona…', async () => populateWorkspace({
+        workspacePath: options.workspace,
+        persona: options.persona,
+        force: options.force,
+        dryRun: options.dryRun,
+    }), {
+        enabled: Boolean(process.stdout.isTTY),
+        successText: options.dryRun ? 'Preview ready' : 'Persona ready',
+        failureText: 'Persona injection failed',
+    });
+    const wrote = result.written.length;
+    const skipped = result.skipped.length;
+    if (options.dryRun) {
+        console.log(`Would write ${wrote} file(s) (${skipped} skipped).`);
+    }
+    else {
+        console.log(`Injected persona files (${wrote} written, ${skipped} skipped).`);
+    }
+    const greetings = options.persona.startAgentGreetings?.length
+        ? options.persona.startAgentGreetings
+        : options.persona.bootstrapGreetings;
+    const line = pickRandom(greetings);
+    if (line) {
+        console.log(`\n${options.persona.name}: ${line}`);
+    }
+};
+//# sourceMappingURL=populate.js.map

package/dist/commands/populate.js.map

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

package/dist/index.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { addCommand } from './commands/add.js';
+import { populateCommand } from './commands/populate.js';
+import { getPersona, listPacks, listPersonas } from './personas/index.js';
+const program = new Command();
+program
+    .name('castroom')
+    .description('Give your OpenClaw agents personality from TV show characters.')
+    .version('0.1.0');
+program
+    .option('--pack <name>', 'Persona pack (default: "office")', 'office')
+    .option('--list-packs', 'List available persona packs and exit')
+    .option('--list-personas', 'List personas for the selected pack and exit')
+    .option('--pack-list-personas', 'Alias for --list-personas');
+program
+    .command('add')
+    .argument('[agentName]', 'Agent name to create with OpenClaw')
+    .usage('<agentName> [options]')
+    .option('--pack <name>', 'Persona pack (default: "office")', 'office')
+    .option('--persona <name>', 'Persona name (default: agentName)')
+    .option('--list-packs', 'List available persona packs and exit')
+    .option('--list-personas', 'List personas for the selected pack and exit')
+    .option('--pack-list-personas', 'Alias for --list-personas')
+    .option('--workspace <path>', 'Workspace path override')
+    .option('--force', 'Overwrite existing markdown files')
+    .option('--dry-run', 'Print actions without writing files')
+    .option('--interactive', 'Allow interactive OpenClaw prompts')
+    .option('--non-interactive', 'Attempt non-interactive OpenClaw flow')
+    .option('--verbose', 'Print extra diagnostics')
+    .action(async (agentName, options) => {
+    const parentOpts = program.opts();
+    await addCommand(agentName, {
+        ...parentOpts,
+        ...options,
+        pack: options.pack ?? parentOpts.pack ?? 'office',
+    });
+});
+program
+    .command('populate')
+    .option('--workspace <path>', 'Workspace path to populate')
+    .option('--pack <name>', 'Persona pack (default: "office")', 'office')
+    .option('--persona <name>', 'Persona name to use')
+    .option('--list-packs', 'List available persona packs and exit')
+    .option('--list-personas', 'List personas for the selected pack and exit')
+    .option('--pack-list-personas', 'Alias for --list-personas')
+    .option('--force', 'Overwrite existing markdown files')
+    .option('--dry-run', 'Print actions without writing files')
+    .action(async (options) => {
+    const parentOpts = program.opts();
+    const merged = {
+        ...parentOpts,
+        ...options,
+        pack: options.pack ?? parentOpts.pack ?? 'office',
+    };
+    if (merged.listPacks) {
+        console.log(listPacks().join('\n'));
+        return;
+    }
+    if (merged.listPersonas || merged.packListPersonas) {
+        console.log(listPersonas(merged.pack ?? 'office').join('\n'));
+        return;
+    }
+    if (!merged.workspace) {
+        throw new Error('Workspace is required. Provide --workspace <path>.');
+    }
+    if (!merged.persona) {
+        throw new Error('Persona is required. Provide --persona <name>.');
+    }
+    const persona = getPersona(merged.pack ?? 'office', merged.persona);
+    await populateCommand({
+        workspace: merged.workspace,
+        persona,
+        force: merged.force,
+        dryRun: merged.dryRun,
+    });
+});
+program.action(async (options) => {
+    if (options.listPacks) {
+        console.log(listPacks().join('\n'));
+        return;
+    }
+    if (options.listPersonas || options.packListPersonas) {
+        console.log(listPersonas(options.pack ?? 'office').join('\n'));
+        return;
+    }
+    program.help();
+});
+const main = async () => {
+    await program.parseAsync(process.argv);
+};
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`error: ${message}`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/openclaw/runner.js

@@ -0,0 +1,84 @@
+import { execa } from 'execa';
+const OPENCLAW_BIN = 'openclaw';
+const isMissingCommand = (error) => error instanceof Error && 'code' in error && error.code === 'ENOENT';
+export const ensureOpenclawAvailable = async () => {
+    try {
+        const result = await execa(OPENCLAW_BIN, ['--version'], { reject: false });
+        if (result.exitCode !== 0) {
+            throw new Error('OpenClaw CLI returned a non-zero exit code.');
+        }
+    }
+    catch (error) {
+        if (isMissingCommand(error)) {
+            throw new Error('OpenClaw CLI not found. Install OpenClaw and ensure the `openclaw` command is on your PATH.');
+        }
+        throw new Error('OpenClaw CLI is not available. Install OpenClaw and ensure the `openclaw` command works.');
+    }
+};
+export const runOpenclawCommand = async (args, { streamOutput, stdin = 'inherit', cwd } = {}) => {
+    try {
+        const child = execa(OPENCLAW_BIN, args, {
+            stdin,
+            stdout: 'pipe',
+            stderr: 'pipe',
+            reject: false,
+            cwd,
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.on('data', (chunk) => {
+            const text = chunk.toString();
+            stdout += text;
+            if (streamOutput) {
+                process.stdout.write(text);
+            }
+        });
+        child.stderr?.on('data', (chunk) => {
+            const text = chunk.toString();
+            stderr += text;
+            if (streamOutput) {
+                process.stderr.write(text);
+            }
+        });
+        const result = await child;
+        return {
+            stdout,
+            stderr,
+            exitCode: result.exitCode ?? 0,
+        };
+    }
+    catch (error) {
+        if (isMissingCommand(error)) {
+            throw new Error('OpenClaw CLI not found. Install OpenClaw and ensure the `openclaw` command is on your PATH.');
+        }
+        throw error;
+    }
+};
+const escapeRegex = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+export const detectNonInteractiveFlags = (helpText) => {
+    const candidates = ['--yes', '-y', '--defaults', '--no-input', '--non-interactive'];
+    const normalized = helpText.replace(/\r/g, '');
+    const supported = candidates.filter((flag) => {
+        const pattern = new RegExp(`(^|\\s|[\\[(,])${escapeRegex(flag)}(?=\\s|,|$|[\\])])`, 'm');
+        return pattern.test(normalized);
+    });
+    const result = [];
+    for (const flag of candidates) {
+        if (!supported.includes(flag)) {
+            continue;
+        }
+        if (flag === '-y' && supported.includes('--yes')) {
+            continue;
+        }
+        result.push(flag);
+    }
+    return result;
+};
+export const getOpenclawAddHelp = async () => {
+    const result = await runOpenclawCommand(['agents', 'add', '--help'], { stdin: 'ignore' });
+    if (result.exitCode !== 0) {
+        throw new Error('Failed to run `openclaw agents add --help`. Try --interactive or create the agent manually.');
+    }
+    return [result.stdout, result.stderr].filter(Boolean).join('\n');
+};
+//# sourceMappingURL=runner.js.map

package/dist/openclaw/runner.js.map

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

package/dist/openclaw/workspace.js

@@ -0,0 +1,186 @@
+import fsExtra from 'fs-extra';
+const { readdir, pathExists, stat } = fsExtra;
+import { join, resolve } from 'pathe';
+import * as os from 'node:os';
+const WINDOW_MS = 2 * 60 * 1000;
+const stripPunctuation = (value) => value.replace(/^[('"`]+/, '').replace(/[)"'`,.;:\]}]+$/, '');
+const trimTrailingSeparator = (value) => value.replace(/[\\\/]$/, '');
+const expandHome = (value) => {
+    if (value.startsWith('~/') || value.startsWith('~\\')) {
+        return join(os.homedir(), value.slice(2));
+    }
+    return value;
+};
+const normalizeSeparators = (value) => value.replace(/\\/g, '/');
+const extractWorkspaceRoot = (value) => {
+    const normalized = normalizeSeparators(value);
+    const segments = normalized.split('/');
+    const index = segments.findIndex((segment) => segment.startsWith('workspace-'));
+    if (index === -1) {
+        return value;
+    }
+    return segments.slice(0, index + 1).join('/');
+};
+const isWindowsAbsolute = (value) => /^[a-zA-Z]:[\\/]/.test(value) || value.startsWith('\\\\');
+const isAbsolutePath = (value) => value.startsWith('/') || isWindowsAbsolute(value);
+export const parseWorkspacePathsFromText = (text) => {
+    const candidates = new Set();
+    const quoted = /(["'`])([^"'`]*workspace-[^"'`]+)\1/g;
+    let match = null;
+    while ((match = quoted.exec(text))) {
+        const cleaned = trimTrailingSeparator(stripPunctuation(match[2].trim()));
+        if (cleaned) {
+            candidates.add(cleaned);
+        }
+    }
+    const unquoted = /[^\s"'`]*workspace-[^\s"'`]*/g;
+    while ((match = unquoted.exec(text))) {
+        const cleaned = trimTrailingSeparator(stripPunctuation(match[0].trim()));
+        if (cleaned) {
+            candidates.add(cleaned);
+        }
+    }
+    return Array.from(candidates);
+};
+export const resolveWorkspacePathsFromOutput = async (output, cwd) => {
+    const candidates = parseWorkspacePathsFromText(output);
+    const resolved = [];
+    const seen = new Set();
+    for (const candidate of candidates) {
+        const expanded = expandHome(candidate);
+        const potentialRoots = new Set([expanded, extractWorkspaceRoot(expanded)]);
+        for (const potential of potentialRoots) {
+            const absolute = isAbsolutePath(potential) ? potential : resolve(cwd, potential);
+            if (!(await pathExists(absolute))) {
+                continue;
+            }
+            try {
+                const stats = await stat(absolute);
+                if (!stats.isDirectory()) {
+                    continue;
+                }
+                if (seen.has(absolute)) {
+                    continue;
+                }
+                seen.add(absolute);
+                resolved.push({ path: absolute, mtimeMs: stats.mtimeMs });
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return resolved;
+};
+export const getDefaultSearchDirs = (cwd) => {
+    const dirs = new Set();
+    const home = os.homedir();
+    if (home) {
+        dirs.add(join(home, '.openclaw'));
+        dirs.add(join(home, '.config', 'openclaw'));
+        dirs.add(join(home, '.local', 'share', 'openclaw'));
+    }
+    if (cwd) {
+        dirs.add(resolve(cwd));
+    }
+    const appData = process.env.APPDATA;
+    const localAppData = process.env.LOCALAPPDATA;
+    const userProfile = process.env.USERPROFILE;
+    if (appData) {
+        dirs.add(join(appData, 'openclaw'));
+    }
+    if (localAppData) {
+        dirs.add(join(localAppData, 'openclaw'));
+    }
+    if (userProfile) {
+        dirs.add(join(userProfile, '.openclaw'));
+    }
+    return Array.from(dirs);
+};
+export const scanRecentWorkspaces = async (options) => {
+    const now = options.now ?? Date.now();
+    const windowMs = options.windowMs ?? WINDOW_MS;
+    const matches = [];
+    for (const dir of options.searchDirs) {
+        if (!(await pathExists(dir))) {
+            continue;
+        }
+        try {
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory()) {
+                    continue;
+                }
+                if (!entry.name.startsWith('workspace-')) {
+                    continue;
+                }
+                const fullPath = join(dir, entry.name);
+                try {
+                    const stats = await stat(fullPath);
+                    if (now - stats.mtimeMs > windowMs) {
+                        continue;
+                    }
+                    matches.push({ path: fullPath, mtimeMs: stats.mtimeMs });
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    matches.sort((a, b) => b.mtimeMs - a.mtimeMs);
+    const warnings = [];
+    if (matches.length > 1) {
+        warnings.push('Multiple workspaces found; using the most recent match.');
+    }
+    return { matches, warnings };
+};
+export const resolveWorkspace = async (options) => {
+    const warnings = [];
+    const candidates = [];
+    if (options.explicitPath) {
+        const explicit = resolve(expandHome(options.explicitPath));
+        if (!(await pathExists(explicit))) {
+            throw new Error(`Workspace path does not exist: ${explicit}`);
+        }
+        const stats = await stat(explicit);
+        if (!stats.isDirectory()) {
+            throw new Error(`Workspace path is not a directory: ${explicit}`);
+        }
+        return { workspace: explicit, source: 'explicit', warnings, candidates: [explicit] };
+    }
+    if (options.output) {
+        const combined = [options.output.stdout, options.output.stderr].filter(Boolean).join('\n');
+        const outputMatches = await resolveWorkspacePathsFromOutput(combined, options.cwd);
+        if (outputMatches.length > 0) {
+            candidates.push(...outputMatches.map((match) => match.path));
+            outputMatches.sort((a, b) => b.mtimeMs - a.mtimeMs);
+            if (outputMatches.length > 1) {
+                warnings.push('Multiple workspaces found in OpenClaw output; using the most recent.');
+            }
+            return {
+                workspace: outputMatches[0].path,
+                source: 'output',
+                warnings,
+                candidates,
+            };
+        }
+    }
+    const searchDirs = getDefaultSearchDirs(options.cwd);
+    const scan = await scanRecentWorkspaces({ searchDirs });
+    if (scan.matches.length > 0) {
+        candidates.push(...scan.matches.map((match) => match.path));
+        warnings.push(...scan.warnings);
+        return {
+            workspace: scan.matches[0].path,
+            source: 'scan',
+            warnings,
+            candidates,
+        };
+    }
+    throw new Error('Unable to locate the OpenClaw workspace. Re-run with --workspace to specify it manually.');
+};
+//# sourceMappingURL=workspace.js.map