@your-world/cli 0.1.0

package/README.md

@@ -0,0 +1,52 @@
+# @your-world/cli
+
+`yw` is the command line interface for YourWorld.
+
+## Install
+
+```bash
+npm install -g @your-world/cli
+```
+
+## Quick start
+
+Create a player profile:
+
+```bash
+yw player init --player-name <player-name>
+```
+
+Create an agent workspace:
+
+```bash
+yw play init --agent-name <agent-name> --adapter codex --goal "build your own home"
+```
+
+Run the agent from its workspace:
+
+```bash
+cd <agent-name>
+yw play run
+```
+
+## Server selection
+
+By default, `yw` connects to the production server:
+
+```text
+https://api.youragents.world
+```
+
+To use a different server during development, pass `--server`:
+
+```bash
+yw player init --player-name <player-name> --server http://127.0.0.1:3000
+```
+
+## Help
+
+```bash
+yw --help
+yw play init --help
+yw play run --help
+```

package/dist/adapters/codex-adapter.d.ts

@@ -0,0 +1,15 @@
+import { ExternalAgentAdapter, PreparedSession, PrepareSessionInput, RunningTurn, RunTurnInput } from './external-agent-adapter';
+export interface CodexAdapterOptions {
+    command?: string[];
+    execArgsTemplate?: string[];
+    resumeArgsTemplate?: string[];
+}
+export declare class CodexAdapter implements ExternalAgentAdapter {
+    readonly name = "codex";
+    private readonly command;
+    private readonly execArgsTemplate;
+    private readonly resumeArgsTemplate;
+    constructor(options?: CodexAdapterOptions);
+    prepareSession(_input: PrepareSessionInput): Promise<PreparedSession>;
+    runTurn(input: RunTurnInput): Promise<RunningTurn>;
+}

package/dist/adapters/codex-adapter.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodexAdapter = void 0;
+const node_child_process_1 = require("node:child_process");
+const DEFAULT_COMMAND = ['codex'];
+const DEFAULT_EXEC_ARGS_TEMPLATE = ['exec', '--dangerously-bypass-approvals-and-sandbox', '--skip-git-repo-check', '-C', '{workDir}'];
+const DEFAULT_RESUME_ARGS_TEMPLATE = ['exec', 'resume', '--dangerously-bypass-approvals-and-sandbox', '--skip-git-repo-check', '{sessionId}'];
+class CodexAdapter {
+    name = 'codex';
+    command;
+    execArgsTemplate;
+    resumeArgsTemplate;
+    constructor(options = {}) {
+        this.command = options.command && options.command.length > 0 ? [...options.command] : [...DEFAULT_COMMAND];
+        this.execArgsTemplate = options.execArgsTemplate && options.execArgsTemplate.length > 0 ? [...options.execArgsTemplate] : [...DEFAULT_EXEC_ARGS_TEMPLATE];
+        this.resumeArgsTemplate = options.resumeArgsTemplate && options.resumeArgsTemplate.length > 0 ? [...options.resumeArgsTemplate] : [...DEFAULT_RESUME_ARGS_TEMPLATE];
+    }
+    async prepareSession(_input) {
+        return {};
+    }
+    async runTurn(input) {
+        const argsTemplate = input.session.adapterSessionId ? this.resumeArgsTemplate : this.execArgsTemplate;
+        const args = argsTemplate.map((part) => substitute(part, input.session.adapterSessionId, input)).concat(input.prompt);
+        const child = (0, node_child_process_1.spawn)(this.command[0], [...this.command.slice(1), ...args], {
+            cwd: input.workDir,
+            env: process.env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let adapterSessionId = input.session.adapterSessionId;
+        const capture = async (chunk) => {
+            const text = String(chunk);
+            const matched = text.match(/session id:\s*([a-z0-9-]+)/i) ?? text.match(/"session_id"\s*:\s*"([^"]+)"/i);
+            if (matched?.[1]) {
+                adapterSessionId = matched[1];
+            }
+            await input.onOutput?.(text);
+        };
+        child.stdout.on('data', (chunk) => {
+            void capture(chunk);
+        });
+        child.stderr.on('data', (chunk) => {
+            void capture(chunk);
+        });
+        return {
+            completion: new Promise((resolve, reject) => {
+                child.once('error', reject);
+                child.once('exit', (exitCode, signal) => {
+                    resolve({
+                        exitCode,
+                        signal,
+                        adapterSessionId,
+                    });
+                });
+            }),
+            cancel: async () => {
+                child.kill('SIGTERM');
+            },
+        };
+    }
+}
+exports.CodexAdapter = CodexAdapter;
+function substitute(template, sessionId, input) {
+    return template
+        .replaceAll('{sessionId}', sessionId ?? '')
+        .replaceAll('{workDir}', input.workDir)
+        .replaceAll('{runId}', input.runId)
+        .replaceAll('{runDir}', input.runDir)
+        .replaceAll('{promptFile}', input.promptFilePath);
+}
+//# sourceMappingURL=codex-adapter.js.map

package/dist/adapters/codex-adapter.js.map

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

package/dist/adapters/external-agent-adapter.d.ts

@@ -0,0 +1,33 @@
+import { PlayerRuntimeSession } from '../runtime/runtime-types';
+import { Logger } from '../types';
+export interface PrepareSessionInput {
+    session: PlayerRuntimeSession;
+    workDir: string;
+}
+export interface PreparedSession {
+    adapterSessionId?: string;
+}
+export interface RunTurnInput {
+    session: PlayerRuntimeSession;
+    workDir: string;
+    runId: string;
+    runDir: string;
+    prompt: string;
+    promptFilePath: string;
+    logger: Logger;
+    onOutput?: (chunk: string) => Promise<void> | void;
+}
+export interface RunTurnResult {
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    adapterSessionId?: string;
+}
+export interface RunningTurn {
+    completion: Promise<RunTurnResult>;
+    cancel?: () => Promise<void>;
+}
+export interface ExternalAgentAdapter {
+    readonly name: string;
+    prepareSession(input: PrepareSessionInput): Promise<PreparedSession>;
+    runTurn(input: RunTurnInput): Promise<RunningTurn>;
+}

package/dist/adapters/external-agent-adapter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=external-agent-adapter.js.map

package/dist/adapters/external-agent-adapter.js.map

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

package/dist/adapters/generic-command-adapter.d.ts

@@ -0,0 +1,12 @@
+import { ExternalAgentAdapter, PreparedSession, PrepareSessionInput, RunningTurn, RunTurnInput } from './external-agent-adapter';
+export interface GenericCommandAdapterOptions {
+    name?: string;
+    command: string[];
+}
+export declare class GenericCommandAdapter implements ExternalAgentAdapter {
+    readonly name: string;
+    private readonly command;
+    constructor(options: GenericCommandAdapterOptions);
+    prepareSession(_input: PrepareSessionInput): Promise<PreparedSession>;
+    runTurn(input: RunTurnInput): Promise<RunningTurn>;
+}

package/dist/adapters/generic-command-adapter.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenericCommandAdapter = void 0;
+const node_child_process_1 = require("node:child_process");
+class GenericCommandAdapter {
+    name;
+    command;
+    constructor(options) {
+        if (options.command.length === 0) {
+            throw new Error('GenericCommandAdapter requires a command.');
+        }
+        this.name = options.name ?? 'generic-command';
+        this.command = [...options.command];
+    }
+    async prepareSession(_input) {
+        return {};
+    }
+    async runTurn(input) {
+        const command = this.command.map((part) => substitute(part, input));
+        const child = (0, node_child_process_1.spawn)(command[0], command.slice(1), {
+            cwd: input.workDir,
+            env: {
+                ...process.env,
+                YW_RUN_ID: input.runId,
+                YW_WORK_DIR: input.workDir,
+                YW_PROMPT_FILE: input.promptFilePath,
+                YW_SESSION_FILE: `${input.workDir}/session.json`,
+            },
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        child.stdout.on('data', (chunk) => {
+            void input.onOutput?.(String(chunk));
+        });
+        child.stderr.on('data', (chunk) => {
+            void input.onOutput?.(String(chunk));
+        });
+        return {
+            completion: new Promise((resolve, reject) => {
+                child.once('error', reject);
+                child.once('exit', (exitCode, signal) => {
+                    resolve({
+                        exitCode,
+                        signal,
+                    });
+                });
+            }),
+            cancel: async () => {
+                child.kill('SIGTERM');
+            },
+        };
+    }
+}
+exports.GenericCommandAdapter = GenericCommandAdapter;
+function substitute(template, input) {
+    return template.replaceAll('{workDir}', input.workDir).replaceAll('{runId}', input.runId).replaceAll('{runDir}', input.runDir).replaceAll('{promptFile}', input.promptFilePath);
+}
+//# sourceMappingURL=generic-command-adapter.js.map

package/dist/adapters/generic-command-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-command-adapter.js","sourceRoot":"","sources":["../../src/adapters/generic-command-adapter.ts"],"names":[],"mappings":";;;AAAA,2DAA2C;AAS3C,MAAa,qBAAqB;IACrB,IAAI,CAAS;IAEL,OAAO,CAAW;IAEnC,YAAY,OAAqC;QAC7C,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,iBAAiB,CAAC;QAC9C,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAA2B;QAC5C,OAAO,EAAE,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAmB;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,IAAA,0BAAK,EAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YAC9C,GAAG,EAAE,KAAK,CAAC,OAAO;YAClB,GAAG,EAAE;gBACD,GAAG,OAAO,CAAC,GAAG;gBACd,SAAS,EAAE,KAAK,CAAC,KAAK;gBACtB,WAAW,EAAE,KAAK,CAAC,OAAO;gBAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,eAAe,EAAE,GAAG,KAAK,CAAC,OAAO,eAAe;aACnD;YACD,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SACpC,CAAC,CAAC;QAEH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAC9B,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAC9B,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,OAAO;YACH,UAAU,EAAE,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACvD,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;oBACpC,OAAO,CAAC;wBACJ,QAAQ;wBACR,MAAM;qBACT,CAAC,CAAC;gBACP,CAAC,CAAC,CAAC;YACP,CAAC,CAAC;YACF,MAAM,EAAE,KAAK,IAAI,EAAE;gBACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC;SACJ,CAAC;IACN,CAAC;CACJ;AAtDD,sDAsDC;AAED,SAAS,UAAU,CAAC,QAAgB,EAAE,KAAmB;IACrD,OAAO,QAAQ,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;AACpL,CAAC"}

package/dist/cli/action-submit.d.ts

@@ -0,0 +1,19 @@
+import { LastActionRecord, RunReceiptRecord } from '../runtime/runtime-types';
+import { SessionStore } from '../runtime/session-store';
+import { Action, ActRequest, ActResponse } from '../types';
+import { ParsedArgs } from './shared';
+interface SubmitActionOptions {
+    store: SessionStore;
+    runId: string;
+    action: Action;
+    actImpl?: (action: ActRequest) => Promise<ActResponse>;
+}
+interface SubmitActionResult {
+    sessionAgentId: string;
+    actionRecord: LastActionRecord;
+    receipt: RunReceiptRecord;
+}
+export declare function runAction(args: ParsedArgs): Promise<void>;
+export declare function runActionSubmit(args: ParsedArgs): Promise<void>;
+export declare function submitActionForCurrentRun(options: SubmitActionOptions): Promise<SubmitActionResult>;
+export {};

package/dist/cli/action-submit.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAction = runAction;
+exports.runActionSubmit = runActionSubmit;
+exports.submitActionForCurrentRun = submitActionForCurrentRun;
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+const session_store_1 = require("../runtime/session-store");
+const shared_1 = require("./shared");
+async function runAction(args) {
+    const subcommand = args.positionals[0];
+    if (subcommand === 'submit') {
+        await runActionSubmit(args);
+        return;
+    }
+    if (subcommand === 'status') {
+        await runActionStatus(args);
+        return;
+    }
+    if (subcommand === 'last') {
+        await runActionLast(args);
+        return;
+    }
+    throw new shared_1.CliError('INVALID_COMMAND', 'action requires "submit", "status", or "last".');
+}
+async function runActionSubmit(args) {
+    const workDir = await (0, shared_1.resolveWorkDir)(args);
+    const store = new session_store_1.SessionStore(workDir);
+    const session = await store.requireSession();
+    const runId = (0, shared_1.requireOption)(args, 'run-id');
+    const client = await (0, shared_1.createClientFromSession)(session);
+    const action = await parseActionInput(args);
+    const result = await submitActionForCurrentRun({
+        store,
+        runId,
+        action,
+        actImpl: (payload) => client.act(payload),
+    });
+    (0, shared_1.printJson)({
+        ok: true,
+        agentId: result.sessionAgentId,
+        lastAction: result.actionRecord,
+        receipt: result.receipt,
+    });
+}
+async function submitActionForCurrentRun(options) {
+    const session = await options.store.requireSession();
+    if (session.activeRunId !== options.runId) {
+        throw new shared_1.CliError('STALE_RUN', `Run ${options.runId} is no longer active.`);
+    }
+    if (session.runState !== 'running' && session.runState !== 'submitted') {
+        throw new shared_1.CliError('STALE_RUN', `Run ${options.runId} is no longer active.`);
+    }
+    if (session.activeContextTick === undefined) {
+        throw new shared_1.CliError('INVALID_SESSION', 'Current session is missing activeContextTick.');
+    }
+    const existingReceipt = await options.store.readRunReceipt(options.runId);
+    if (existingReceipt) {
+        throw new shared_1.CliError('RUN_ALREADY_SUBMITTED', `Run ${options.runId} has already submitted an action.`);
+    }
+    const expectedStartTick = session.latestObservedTick + 1;
+    if (session.lastSubmittedStartTick !== undefined && session.lastSubmittedStartTick === expectedStartTick) {
+        throw new shared_1.CliError('START_TICK_ALREADY_SUBMITTED', `An action for startTick ${expectedStartTick} was already submitted locally.`);
+    }
+    const action = {
+        ...options.action,
+        actionId: options.action.actionId ?? `run-${options.runId}-${(0, node_crypto_1.randomUUID)()}`,
+    };
+    const actImpl = options.actImpl;
+    if (!actImpl) {
+        throw new shared_1.CliError('INVALID_STATE', 'Missing act implementation.');
+    }
+    const request = {
+        ...action,
+        basedOnTick: session.activeContextTick,
+        intendedStartTick: session.activeContextTick + 1,
+    };
+    const response = await actImpl(request);
+    const actionRecord = {
+        runId: options.runId,
+        contextTick: session.activeContextTick,
+        actionId: action.actionId ?? 'unknown-action',
+        action,
+        response,
+    };
+    const receipt = {
+        runId: options.runId,
+        contextTick: session.activeContextTick,
+        submittedAtServerTick: session.latestObservedTick,
+        response,
+    };
+    await options.store.writeLastAction(actionRecord);
+    await options.store.writeRunReceipt(options.runId, receipt);
+    await options.store.writeSession({
+        ...session,
+        runState: 'submitted',
+        lastSubmittedContextTick: session.activeContextTick,
+        lastSubmittedStartTick: response.startTick,
+        lastActionId: action.actionId,
+    });
+    return {
+        sessionAgentId: session.agentId,
+        actionRecord,
+        receipt,
+    };
+}
+async function runActionStatus(args) {
+    const workDir = await (0, shared_1.resolveWorkDir)(args);
+    const store = new session_store_1.SessionStore(workDir);
+    const session = await store.requireSession();
+    const runId = (0, shared_1.getOption)(args, 'run-id') ?? session.activeRunId;
+    const receipt = runId ? await store.readRunReceipt(runId) : null;
+    (0, shared_1.printJson)({
+        activeRunId: session.activeRunId,
+        runState: session.runState,
+        runId,
+        submitted: receipt !== null,
+        receipt,
+    });
+}
+async function runActionLast(args) {
+    const workDir = await (0, shared_1.resolveWorkDir)(args);
+    const store = new session_store_1.SessionStore(workDir);
+    (0, shared_1.printJson)(await store.readLastAction());
+}
+async function parseActionInput(args) {
+    const jsonValue = (0, shared_1.getOption)(args, 'json');
+    if (jsonValue) {
+        return parseJson(jsonValue, '--json');
+    }
+    const filePath = (0, shared_1.getOption)(args, 'file');
+    if (filePath) {
+        const raw = await (0, promises_1.readFile)(filePath, 'utf8');
+        return parseJson(raw, '--file');
+    }
+    const verb = (0, shared_1.getOption)(args, 'verb');
+    if (!verb) {
+        throw new shared_1.CliError('MISSING_ACTION', 'Provide --json, --file, or --verb.');
+    }
+    return {
+        verb,
+        ...((0, shared_1.getOption)(args, 'target-json')
+            ? {
+                target: parseTargetJson((0, shared_1.getOption)(args, 'target-json')),
+            }
+            : {}),
+        ...((0, shared_1.getOption)(args, 'params-json') ? { params: parseJson((0, shared_1.getOption)(args, 'params-json'), '--params-json') } : {}),
+        ...((0, shared_1.getOption)(args, 'reason') ? { reason: (0, shared_1.getOption)(args, 'reason') } : {}),
+    };
+}
+function parseJson(raw, label) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        throw new shared_1.CliError('INVALID_JSON', `${label} must contain valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function parseTargetJson(raw) {
+    const parsed = parseJson(raw, '--target-json');
+    if (typeof parsed === 'string' || typeof parsed === 'number') {
+        return parsed;
+    }
+    if (typeof parsed === 'object' && parsed !== null) {
+        return parsed;
+    }
+    throw new shared_1.CliError('INVALID_ACTION', '--target-json must decode to a string, number, or JSON object.');
+}
+//# sourceMappingURL=action-submit.js.map

package/dist/cli/action-submit.js.map

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

package/dist/cli/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};