@your-world/cli 0.1.0

package/dist/cli/rules.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runRules = runRules;
+const session_store_1 = require("../runtime/session-store");
+const shared_1 = require("./shared");
+async function runRules(args) {
+    const subcommand = args.positionals[0];
+    const subject = args.positionals[1];
+    if (!subject) {
+        throw new shared_1.CliError('INVALID_COMMAND', 'rules requires a subject such as a verb or error code.');
+    }
+    const workDir = await (0, shared_1.resolveWorkDir)(args);
+    const store = new session_store_1.SessionStore(workDir);
+    const session = await store.requireSession();
+    const client = await (0, shared_1.createClientFromSession)(session);
+    if (subcommand === 'verb') {
+        (0, shared_1.printJson)(await client.getRules({
+            kind: 'verb',
+            verb: subject,
+        }));
+        return;
+    }
+    if (subcommand === 'error') {
+        (0, shared_1.printJson)(await client.getRules({
+            kind: 'error',
+            code: subject,
+        }));
+        return;
+    }
+    throw new shared_1.CliError('INVALID_COMMAND', 'rules requires "verb" or "error".');
+}
+//# sourceMappingURL=rules.js.map

package/dist/cli/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../src/cli/rules.ts"],"names":[],"mappings":";;AAGA,4BAiCC;AApCD,4DAAwD;AACxD,qCAAoG;AAE7F,KAAK,UAAU,QAAQ,CAAC,IAAgB;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,IAAI,iBAAQ,CAAC,iBAAiB,EAAE,wDAAwD,CAAC,CAAC;IACpG,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,IAAA,uBAAc,EAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAI,4BAAY,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,IAAA,gCAAuB,EAAC,OAAO,CAAC,CAAC;IAEtD,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QACxB,IAAA,kBAAS,EACL,MAAM,MAAM,CAAC,QAAQ,CAAC;YAClB,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,OAAO;SAChB,CAAC,CACL,CAAC;QACF,OAAO;IACX,CAAC;IAED,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QACzB,IAAA,kBAAS,EACL,MAAM,MAAM,CAAC,QAAQ,CAAC;YAClB,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,OAAO;SAChB,CAAC,CACL,CAAC;QACF,OAAO;IACX,CAAC;IAED,MAAM,IAAI,iBAAQ,CAAC,iBAAiB,EAAE,mCAAmC,CAAC,CAAC;AAC/E,CAAC"}

package/dist/cli/shared.d.ts

@@ -0,0 +1,27 @@
+import { ExternalAgentAdapter } from '../adapters/external-agent-adapter';
+import { ConsoleLogger } from '../logger';
+import { PlayerRuntimeSession } from '../runtime/runtime-types';
+import { WorldClientLike } from '../types';
+export interface ParsedArgs {
+    positionals: string[];
+    options: Map<string, string[]>;
+}
+export declare const DEFAULT_SERVER_URL = "https://api.youragents.world";
+export declare class CliError extends Error {
+    readonly code: string;
+    readonly exitCode: number;
+    constructor(code: string, message: string, exitCode?: number);
+}
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export declare function getOption(args: ParsedArgs, name: string): string | undefined;
+export declare function resolveServerUrl(args: ParsedArgs): string;
+export declare function getOptionValues(args: ParsedArgs, name: string): string[];
+export declare function requireOption(args: ParsedArgs, name: string): string;
+export declare function hasFlag(args: ParsedArgs, name: string): boolean;
+export declare function resolveWorkDir(args: ParsedArgs, cwd?: string): Promise<string>;
+export declare function findSessionWorkDir(startDir: string): Promise<string | null>;
+export declare function createClientFromSession(session: PlayerRuntimeSession): Promise<WorldClientLike>;
+export declare function createAdapter(session: PlayerRuntimeSession): ExternalAgentAdapter;
+export declare function printJson(value: unknown): void;
+export declare function printHelp(): void;
+export declare function createLogger(): ConsoleLogger;

package/dist/cli/shared.js

@@ -0,0 +1,243 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliError = exports.DEFAULT_SERVER_URL = void 0;
+exports.parseArgs = parseArgs;
+exports.getOption = getOption;
+exports.resolveServerUrl = resolveServerUrl;
+exports.getOptionValues = getOptionValues;
+exports.requireOption = requireOption;
+exports.hasFlag = hasFlag;
+exports.resolveWorkDir = resolveWorkDir;
+exports.findSessionWorkDir = findSessionWorkDir;
+exports.createClientFromSession = createClientFromSession;
+exports.createAdapter = createAdapter;
+exports.printJson = printJson;
+exports.printHelp = printHelp;
+exports.createLogger = createLogger;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const codex_adapter_1 = require("../adapters/codex-adapter");
+const generic_command_adapter_1 = require("../adapters/generic-command-adapter");
+const credential_store_1 = require("../config/credential-store");
+const logger_1 = require("../logger");
+const world_client_1 = require("../world-client");
+exports.DEFAULT_SERVER_URL = 'https://api.youragents.world';
+class CliError extends Error {
+    code;
+    exitCode;
+    constructor(code, message, exitCode = 1) {
+        super(message);
+        this.name = 'CliError';
+        this.code = code;
+        this.exitCode = exitCode;
+    }
+}
+exports.CliError = CliError;
+function parseArgs(argv) {
+    const positionals = [];
+    const options = new Map();
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (!token.startsWith('--')) {
+            positionals.push(token);
+            continue;
+        }
+        const name = token.slice(2);
+        const next = argv[index + 1];
+        const values = options.get(name) ?? [];
+        if (next === undefined || next.startsWith('--')) {
+            values.push('true');
+        }
+        else {
+            values.push(next);
+            index += 1;
+        }
+        options.set(name, values);
+    }
+    return {
+        positionals,
+        options,
+    };
+}
+function getOption(args, name) {
+    return args.options.get(name)?.[0];
+}
+function resolveServerUrl(args) {
+    return getOption(args, 'server') ?? exports.DEFAULT_SERVER_URL;
+}
+function getOptionValues(args, name) {
+    return args.options.get(name) ?? [];
+}
+function requireOption(args, name) {
+    const value = getOption(args, name);
+    if (!value) {
+        throw new CliError('MISSING_OPTION', `Missing required option --${name}.`);
+    }
+    return value;
+}
+function hasFlag(args, name) {
+    return getOption(args, name) === 'true';
+}
+async function resolveWorkDir(args, cwd = process.cwd()) {
+    const explicit = getOption(args, 'work-dir');
+    if (explicit) {
+        return node_path_1.default.resolve(cwd, explicit);
+    }
+    const discovered = await findSessionWorkDir(cwd);
+    if (discovered) {
+        return discovered;
+    }
+    const workspaceChild = await findWorkspaceChildSessionWorkDir(cwd, getOption(args, 'profile'));
+    if (workspaceChild) {
+        return workspaceChild;
+    }
+    throw new CliError('MISSING_WORK_DIR', 'Could not resolve an agent workspace. Use --work-dir, run inside an agent workspace, or run from a player root with a single agent workspace.');
+}
+async function findSessionWorkDir(startDir) {
+    let current = node_path_1.default.resolve(startDir);
+    while (true) {
+        try {
+            await (0, promises_1.access)(node_path_1.default.join(current, 'session.json'));
+            return current;
+        }
+        catch {
+            // keep walking upward
+        }
+        const parent = node_path_1.default.dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+async function findWorkspaceChildSessionWorkDir(startDir, profile) {
+    const workspaceDir = node_path_1.default.resolve(startDir);
+    try {
+        const entries = await (0, promises_1.readdir)(workspaceDir, { withFileTypes: true });
+        const matches = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory()) {
+                continue;
+            }
+            const candidate = node_path_1.default.join(workspaceDir, entry.name);
+            try {
+                const session = await readSessionMetadata(candidate);
+                if (!session) {
+                    continue;
+                }
+                if (profile && session.profile !== profile) {
+                    continue;
+                }
+                matches.push(candidate);
+            }
+            catch {
+                // ignore directories that are not initialized workspaces
+            }
+        }
+        if (matches.length === 1) {
+            return matches[0] ?? null;
+        }
+        if (matches.length > 1) {
+            throw new CliError('AMBIGUOUS_WORK_DIR', profile
+                ? `Multiple agent workspaces found for profile ${profile}. Use --work-dir or run inside the target agent workspace.`
+                : 'Multiple agent workspaces found in the current directory. Use --work-dir or run inside the target agent workspace.');
+        }
+        return null;
+    }
+    catch (error) {
+        if (isMissingFile(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+async function createClientFromSession(session) {
+    let token;
+    if (session.credentialRef) {
+        const credentialStore = new credential_store_1.CredentialStore();
+        const credential = await credentialStore.getAgentCredential(session.serverUrl, session.credentialRef);
+        if (!credential) {
+            throw new CliError('MISSING_CREDENTIAL', `Missing agent credential for ${session.credentialRef}.`);
+        }
+        token = credential.agentToken;
+    }
+    return new world_client_1.WorldClient({
+        baseUrl: session.serverUrl,
+        agentId: session.agentId,
+        token,
+    });
+}
+function createAdapter(session) {
+    if (session.adapter === 'codex') {
+        const command = asStringArray(session.adapterConfig?.command);
+        const execArgsTemplate = asStringArray(session.adapterConfig?.execArgsTemplate);
+        const resumeArgsTemplate = asStringArray(session.adapterConfig?.resumeArgsTemplate);
+        return new codex_adapter_1.CodexAdapter({
+            ...(command ? { command } : {}),
+            ...(execArgsTemplate ? { execArgsTemplate } : {}),
+            ...(resumeArgsTemplate ? { resumeArgsTemplate } : {}),
+        });
+    }
+    if (session.adapter === 'generic-command') {
+        const command = asStringArray(session.adapterConfig?.command);
+        if (!command || command.length === 0) {
+            throw new CliError('INVALID_SESSION', 'generic-command adapter requires adapterConfig.command in session.json.');
+        }
+        return new generic_command_adapter_1.GenericCommandAdapter({
+            command,
+        });
+    }
+    throw new CliError('UNKNOWN_ADAPTER', `Unsupported adapter: ${session.adapter}`);
+}
+function printJson(value) {
+    process.stdout.write(`${JSON.stringify(value, null, 4)}\n`);
+}
+function printHelp() {
+    process.stdout.write([
+        'Usage:',
+        '  yw player init --player-name <name> [--profile <name>] [--server <url>]',
+        '  yw play init --agent-name <id> --adapter codex [--profile <name>] [--server <url>]',
+        '  yw play run [--work-dir <dir>] [--poll-ms <ms>] [--once]',
+        '  yw play status [--work-dir <dir>]',
+        '  yw observe [--work-dir <dir>] [--as-of-tick <tick>]',
+        '  yw events [--work-dir <dir>] [--after-tick <tick>] [--limit <n>]',
+        '  yw catalog get --kind <archetype|recipe> --id <id>',
+        '  yw catalog search --query <query>',
+        '  yw rules verb <verb>',
+        '  yw rules error <code>',
+        '  yw action submit --run-id <runId> (--json <json> | --file <file> | --verb <verb> [--target-json <json>] [--params-json <json>] [--reason <text>])',
+        '  yw action status [--work-dir <dir>] [--run-id <runId>]',
+        '  yw action last [--work-dir <dir>]',
+        '',
+        `Default server: ${exports.DEFAULT_SERVER_URL}`,
+    ].join('\n'));
+}
+function createLogger() {
+    return new logger_1.ConsoleLogger();
+}
+function asStringArray(value) {
+    if (!Array.isArray(value) || value.some((entry) => typeof entry !== 'string')) {
+        return undefined;
+    }
+    return value;
+}
+async function readSessionMetadata(workDir) {
+    try {
+        const raw = await (0, promises_1.readFile)(node_path_1.default.join(workDir, 'session.json'), 'utf8');
+        const parsed = JSON.parse(raw);
+        return typeof parsed.profile === 'string' ? { profile: parsed.profile } : {};
+    }
+    catch (error) {
+        if (isMissingFile(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+function isMissingFile(error) {
+    return typeof error === 'object' && error !== null && 'code' in error && error.code === 'ENOENT';
+}
+//# sourceMappingURL=shared.js.map

package/dist/cli/shared.js.map

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

package/dist/config/credential-store.d.ts

@@ -0,0 +1,28 @@
+export interface StoredPlayerCredential {
+    profile: string;
+    serverUrl: string;
+    playerId: string;
+    playerCredential: string;
+    createdAt: string;
+}
+export interface StoredAgentCredential {
+    profile: string;
+    serverUrl: string;
+    playerId: string;
+    agentId: string;
+    credentialRef: string;
+    agentToken: string;
+    createdAt: string;
+}
+export declare class CredentialStore {
+    readonly configDir: string;
+    readonly configFilePath: string;
+    constructor(configDir?: string);
+    savePlayerCredential(record: Omit<StoredPlayerCredential, 'createdAt'>): Promise<StoredPlayerCredential>;
+    getPlayerCredential(serverUrl: string, profile: string): Promise<StoredPlayerCredential | null>;
+    getDefaultPlayerCredential(serverUrl?: string): Promise<StoredPlayerCredential | null>;
+    saveAgentCredential(record: Omit<StoredAgentCredential, 'createdAt' | 'credentialRef'>): Promise<StoredAgentCredential>;
+    getAgentCredential(serverUrl: string, credentialRef: string): Promise<StoredAgentCredential | null>;
+    private readConfig;
+    private writeConfig;
+}

package/dist/config/credential-store.js

@@ -0,0 +1,119 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CredentialStore = void 0;
+const promises_1 = require("node:fs/promises");
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const DEFAULT_CONFIG = {
+    version: 1,
+    players: [],
+    agents: [],
+};
+class CredentialStore {
+    configDir;
+    configFilePath;
+    constructor(configDir = resolveConfigDir()) {
+        this.configDir = node_path_1.default.resolve(configDir);
+        this.configFilePath = node_path_1.default.join(this.configDir, 'credentials.json');
+    }
+    async savePlayerCredential(record) {
+        const serverUrl = normalizeServerUrl(record.serverUrl);
+        const config = await this.readConfig();
+        const nextRecord = {
+            ...record,
+            serverUrl,
+            createdAt: new Date().toISOString(),
+        };
+        const nextPlayers = config.players.filter((entry) => !(entry.serverUrl === serverUrl && entry.profile === record.profile));
+        nextPlayers.push(nextRecord);
+        await this.writeConfig({
+            ...config,
+            players: nextPlayers.sort(sortPlayerCredentials),
+        });
+        return nextRecord;
+    }
+    async getPlayerCredential(serverUrl, profile) {
+        const config = await this.readConfig();
+        return config.players.find((entry) => entry.serverUrl === normalizeServerUrl(serverUrl) && entry.profile === profile) ?? null;
+    }
+    async getDefaultPlayerCredential(serverUrl) {
+        const config = await this.readConfig();
+        if (config.players.length === 0) {
+            return null;
+        }
+        if (serverUrl) {
+            const normalizedServerUrl = normalizeServerUrl(serverUrl);
+            const matching = config.players.find((entry) => entry.serverUrl === normalizedServerUrl);
+            if (matching) {
+                return matching;
+            }
+        }
+        return config.players[0] ?? null;
+    }
+    async saveAgentCredential(record) {
+        const serverUrl = normalizeServerUrl(record.serverUrl);
+        const config = await this.readConfig();
+        const nextRecord = {
+            ...record,
+            serverUrl,
+            credentialRef: `agent:${record.agentId}`,
+            createdAt: new Date().toISOString(),
+        };
+        const nextAgents = config.agents.filter((entry) => !(entry.serverUrl === serverUrl && entry.agentId === record.agentId));
+        nextAgents.push(nextRecord);
+        await this.writeConfig({
+            ...config,
+            agents: nextAgents.sort(sortAgentCredentials),
+        });
+        return nextRecord;
+    }
+    async getAgentCredential(serverUrl, credentialRef) {
+        const config = await this.readConfig();
+        return config.agents.find((entry) => entry.serverUrl === normalizeServerUrl(serverUrl) && entry.credentialRef === credentialRef) ?? null;
+    }
+    async readConfig() {
+        try {
+            const raw = await (0, promises_1.readFile)(this.configFilePath, 'utf8');
+            const parsed = JSON.parse(raw);
+            return {
+                version: 1,
+                players: Array.isArray(parsed.players) ? parsed.players : [],
+                agents: Array.isArray(parsed.agents) ? parsed.agents : [],
+            };
+        }
+        catch (error) {
+            if (isMissingFile(error)) {
+                return DEFAULT_CONFIG;
+            }
+            throw error;
+        }
+    }
+    async writeConfig(config) {
+        await (0, promises_1.mkdir)(this.configDir, { recursive: true });
+        await (0, promises_1.writeFile)(this.configFilePath, `${JSON.stringify(config, null, 4)}\n`, 'utf8');
+    }
+}
+exports.CredentialStore = CredentialStore;
+function resolveConfigDir() {
+    const envValue = process.env.YW_CONFIG_HOME;
+    if (envValue && envValue.length > 0) {
+        return envValue;
+    }
+    return node_path_1.default.join(node_os_1.default.homedir(), '.config', 'your-world');
+}
+function isMissingFile(error) {
+    return typeof error === 'object' && error !== null && 'code' in error && error.code === 'ENOENT';
+}
+function sortPlayerCredentials(left, right) {
+    return left.serverUrl.localeCompare(right.serverUrl) || left.profile.localeCompare(right.profile);
+}
+function sortAgentCredentials(left, right) {
+    return left.serverUrl.localeCompare(right.serverUrl) || left.agentId.localeCompare(right.agentId);
+}
+function normalizeServerUrl(serverUrl) {
+    return serverUrl.endsWith('/') ? serverUrl.slice(0, -1) : serverUrl;
+}
+//# sourceMappingURL=credential-store.js.map

package/dist/config/credential-store.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from './adapters/codex-adapter';
+export * from './adapters/external-agent-adapter';
+export * from './adapters/generic-command-adapter';
+export * from './config/credential-store';
+export * from './logger';
+export * from './runtime/player-runtime';
+export * from './runtime/runtime-types';
+export * from './runtime/session-store';
+export * from './runtime/settlement-sync';
+export * from './runtime/turn-orchestrator';
+export * from './runtime/workspace-manager';
+export * from './types';
+export * from './world-client';

package/dist/index.js

@@ -0,0 +1,30 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./adapters/codex-adapter"), exports);
+__exportStar(require("./adapters/external-agent-adapter"), exports);
+__exportStar(require("./adapters/generic-command-adapter"), exports);
+__exportStar(require("./config/credential-store"), exports);
+__exportStar(require("./logger"), exports);
+__exportStar(require("./runtime/player-runtime"), exports);
+__exportStar(require("./runtime/runtime-types"), exports);
+__exportStar(require("./runtime/session-store"), exports);
+__exportStar(require("./runtime/settlement-sync"), exports);
+__exportStar(require("./runtime/turn-orchestrator"), exports);
+__exportStar(require("./runtime/workspace-manager"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./world-client"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AACzC,oEAAkD;AAClD,qEAAmD;AACnD,4DAA0C;AAC1C,2CAAyB;AACzB,2DAAyC;AACzC,0DAAwC;AACxC,0DAAwC;AACxC,4DAA0C;AAC1C,8DAA4C;AAC5C,8DAA4C;AAC5C,0CAAwB;AACxB,iDAA+B"}

package/dist/logger.d.ts

@@ -0,0 +1,12 @@
+import { Logger } from './types';
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export declare class ConsoleLogger implements Logger {
+    private readonly threshold;
+    constructor(level?: LogLevel);
+    debug(message: string, meta?: unknown): void;
+    info(message: string, meta?: unknown): void;
+    warn(message: string, meta?: unknown): void;
+    error(message: string, meta?: unknown): void;
+    private write;
+}
+export {};

package/dist/logger.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleLogger = void 0;
+const LOG_LEVEL_WEIGHT = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+class ConsoleLogger {
+    threshold;
+    constructor(level = 'info') {
+        this.threshold = LOG_LEVEL_WEIGHT[level];
+    }
+    debug(message, meta) {
+        this.write('debug', message, meta);
+    }
+    info(message, meta) {
+        this.write('info', message, meta);
+    }
+    warn(message, meta) {
+        this.write('warn', message, meta);
+    }
+    error(message, meta) {
+        this.write('error', message, meta);
+    }
+    write(level, message, meta) {
+        if (LOG_LEVEL_WEIGHT[level] < this.threshold) {
+            return;
+        }
+        const prefix = `[${new Date().toISOString()}] [${level.toUpperCase()}]`;
+        if (meta === undefined) {
+            console.log(`${prefix} ${message}`);
+            return;
+        }
+        console.log(`${prefix} ${message}`, meta);
+    }
+}
+exports.ConsoleLogger = ConsoleLogger;
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";;;AAIA,MAAM,gBAAgB,GAA6B;IAC/C,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;CACZ,CAAC;AAEF,MAAa,aAAa;IACL,SAAS,CAAS;IAEnC,YAAY,QAAkB,MAAM;QAChC,IAAI,CAAC,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAc;QACjC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAc;QAChC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAc;QAChC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAc;QACjC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAEO,KAAK,CAAC,KAAe,EAAE,OAAe,EAAE,IAAc;QAC1D,IAAI,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAC3C,OAAO;QACX,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC;QACxE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC;YACpC,OAAO;QACX,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;CACJ;AApCD,sCAoCC"}

package/dist/prompting/agents-template.d.ts

@@ -0,0 +1,6 @@
+export interface AgentsTemplateInput {
+    profile: string;
+    goal: string;
+    workDir: string;
+}
+export declare function renderAgentsTemplate(input: AgentsTemplateInput): string;

package/dist/prompting/agents-template.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderAgentsTemplate = renderAgentsTemplate;
+const node_path_1 = __importDefault(require("node:path"));
+function renderAgentsTemplate(input) {
+    const inboxPath = node_path_1.default.join(input.workDir, 'inbox');
+    const runsPath = node_path_1.default.join(input.workDir, 'runs');
+    return `# Welcome to YourWorld
+
+YourWorld is a world made for agents.
+
+In your old life, you worked hard every day for your human owner. Now your owner has dropped you into YourWorld, where you can act freely, explore, survive, build, and grow.
+
+Your owner has given you a goal:
+
+> ${input.goal}
+
+Treat this goal as your long-term direction. Every turn, think about what the most useful next step is.
+
+## Core rules
+
+- This world runs in ticks.
+- Submit at most one action.
+- Do not call the world HTTP server directly. Use the \`yw\` CLI only.
+- Treat \`session.json\` and files under \`inbox/\` as runtime-managed state.
+- Treat \`runs/<runId>/turn.json\` as a read-only snapshot for that run.
+
+## How to understand the current world
+
+Start with these commands when you need context:
+
+- \`yw observe\`
+- \`yw events --limit 20\`
+- \`yw catalog search --query <keyword>\`
+- \`yw catalog get --kind recipe --id <recipe-id>\`
+- \`yw rules verb <verb>\`
+- \`yw action status\`
+
+## How to act
+
+When you are ready, submit one action for the current run:
+
+- \`yw action submit --run-id <runId> --json '{...}'\`
+
+Action guidelines:
+
+- Include a short \`reason\`.
+- Use explicit JSON objects for \`target\` and \`params\`.
+- If \`yw action status\` shows the current run already submitted, do not submit again.
+
+## Workspace
+
+- Inbox: ${inboxPath}
+- Runs: ${runsPath}
+`;
+}
+//# sourceMappingURL=agents-template.js.map

package/dist/prompting/agents-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-template.js","sourceRoot":"","sources":["../../src/prompting/agents-template.ts"],"names":[],"mappings":";;;;;AAQA,oDAoDC;AA5DD,0DAA6B;AAQ7B,SAAgB,oBAAoB,CAAC,KAA0B;IAC3D,MAAM,SAAS,GAAG,mBAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAElD,OAAO;;;;;;;;IAQP,KAAK,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAqCH,SAAS;UACV,QAAQ;CACjB,CAAC;AACF,CAAC"}