ashral 0.1.0

package/dist/adapters/baseAdapter.d.ts

@@ -0,0 +1,35 @@
+import type { SessionStatus } from '../types/session';
+export interface AdapterCommand {
+    /** The executable to spawn (must be on PATH or an absolute path) */
+    command: string;
+    /** Arguments passed directly to the executable */
+    args: string[];
+    /** Additional env vars merged into process.env for this session */
+    env?: Record<string, string>;
+}
+/**
+ * BaseAdapter defines the contract every agent adapter must implement.
+ *
+ * Each adapter is responsible for two things:
+ *  1. Knowing how to build the spawn command for its agent.
+ *  2. Inspecting raw PTY output and mapping it to a session status.
+ *
+ * Keep all agent-specific knowledge inside its adapter. The runner stays generic.
+ */
+export declare abstract class BaseAdapter {
+    /** Human-readable agent identifier, e.g. "claude" */
+    abstract readonly agentName: string;
+    /**
+     * Returns the command and args needed to start the agent.
+     * @param passthroughArgs - extra args forwarded from the CLI (after --)
+     */
+    abstract getCommand(passthroughArgs: string[]): AdapterCommand;
+    /**
+     * Inspects a chunk of raw PTY output and returns a new status if a
+     * transition should occur, or null to leave the status unchanged.
+     *
+     * This is called on every data chunk so keep it fast.
+     */
+    abstract detectStatus(output: string, currentStatus: SessionStatus): SessionStatus | null;
+}
+//# sourceMappingURL=baseAdapter.d.ts.map

package/dist/adapters/baseAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/baseAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,8BAAsB,WAAW;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAEpC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,cAAc;IAE9D;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,aAAa,GAAG,IAAI;CAC1F"}

package/dist/adapters/baseAdapter.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseAdapter = void 0;
+/**
+ * BaseAdapter defines the contract every agent adapter must implement.
+ *
+ * Each adapter is responsible for two things:
+ *  1. Knowing how to build the spawn command for its agent.
+ *  2. Inspecting raw PTY output and mapping it to a session status.
+ *
+ * Keep all agent-specific knowledge inside its adapter. The runner stays generic.
+ */
+class BaseAdapter {
+}
+exports.BaseAdapter = BaseAdapter;
+//# sourceMappingURL=baseAdapter.js.map

package/dist/adapters/baseAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseAdapter.js","sourceRoot":"","sources":["../../src/adapters/baseAdapter.ts"],"names":[],"mappings":";;;AAWA;;;;;;;;GAQG;AACH,MAAsB,WAAW;CAiBhC;AAjBD,kCAiBC"}

package/dist/adapters/claudeAdapter.d.ts

@@ -0,0 +1,9 @@
+import { BaseAdapter, type AdapterCommand } from './baseAdapter';
+import type { SessionStatus } from '../types/session';
+export declare class ClaudeAdapter extends BaseAdapter {
+    readonly agentName = "claude";
+    getCommand(passthroughArgs: string[]): AdapterCommand;
+    detectStatus(raw: string, currentStatus: SessionStatus): SessionStatus | null;
+    private matches;
+}
+//# sourceMappingURL=claudeAdapter.d.ts.map

package/dist/adapters/claudeAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/claudeAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAyDtD,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,SAAS,YAAY;IAE9B,UAAU,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,cAAc;IAQrD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,aAAa,GAAG,IAAI;IAqB7E,OAAO,CAAC,OAAO;CAGhB"}

package/dist/adapters/claudeAdapter.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeAdapter = void 0;
+const baseAdapter_1 = require("./baseAdapter");
+// Strip ANSI/VT escape sequences so regex patterns match clean text
+const ANSI_RE = /\x1B\[[0-9;]*[A-Za-z]|\x1B[@-_][0-?]*[ -/]*[@-~]/g;
+function stripAnsi(raw) {
+    return raw.replace(ANSI_RE, '');
+}
+/**
+ * Heuristic patterns extracted from Claude Code's real terminal output.
+ *
+ * These are intentionally conservative — a false negative (missed transition)
+ * is safer than a false positive (wrong state). Tune as you collect more samples.
+ */
+// Claude is prompting the user to approve a tool call or destructive action
+const APPROVAL_PATTERNS = [
+    /do you want to/i,
+    /allow this/i,
+    /\(y\/n\)/i,
+    /\[y\/n\]/i,
+    /yes\/no/i,
+    /press enter to confirm/i,
+    /approve|deny/i,
+];
+// Claude is waiting for the user to type a new message
+const WAITING_PATTERNS = [
+    /^>\s*$/m, // bare ">" prompt line
+    /\?\s*$/m, // line ending with "?" — note: needs `m` flag so $ matches end-of-line, not end-of-string
+    /^\s*>\s*\d+\./m, // Claude's numbered-choice menu cursor: "> 1. Option"
+    /^\s*\d+\.\s+\S/m, // numbered list of options presented to the user
+    /type something/i, // Claude Code's "5. Type something." freeform option
+    /what would you like/i,
+    /how can i (help|assist)/i,
+    /human:\s*$/im,
+];
+// Claude is actively doing work
+const RUNNING_PATTERNS = [
+    /running|executing|calling tool/i,
+    /writing|creating|updating|deleting/i,
+    /reading|fetching|searching/i,
+    /thinking\.\.\./i,
+];
+// Something clearly went wrong
+const ERROR_PATTERNS = [
+    /^error:/im,
+    /fatal error/i,
+    /uncaught exception/i,
+    /command not found/i,
+    /permission denied/i,
+    /ENOENT|EACCES|ECONNREFUSED/,
+];
+class ClaudeAdapter extends baseAdapter_1.BaseAdapter {
+    constructor() {
+        super(...arguments);
+        this.agentName = 'claude';
+    }
+    getCommand(passthroughArgs) {
+        return {
+            command: 'claude',
+            args: passthroughArgs,
+            // No extra env needed — claude picks up the caller's environment
+        };
+    }
+    detectStatus(raw, currentStatus) {
+        // Never transition out of completed/error via output alone
+        if (currentStatus === 'completed')
+            return null;
+        const text = stripAnsi(raw);
+        if (this.matches(text, APPROVAL_PATTERNS))
+            return 'approval_required';
+        if (this.matches(text, ERROR_PATTERNS))
+            return 'error';
+        if (this.matches(text, WAITING_PATTERNS))
+            return 'waiting_for_input';
+        // Transition back to running only if we were previously paused
+        if (this.matches(text, RUNNING_PATTERNS) &&
+            (currentStatus === 'waiting_for_input' || currentStatus === 'approval_required')) {
+            return 'running';
+        }
+        return null;
+    }
+    matches(text, patterns) {
+        return patterns.some((p) => p.test(text));
+    }
+}
+exports.ClaudeAdapter = ClaudeAdapter;
+//# sourceMappingURL=claudeAdapter.js.map

package/dist/adapters/claudeAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeAdapter.js","sourceRoot":"","sources":["../../src/adapters/claudeAdapter.ts"],"names":[],"mappings":";;;AAAA,+CAAiE;AAGjE,oEAAoE;AACpE,MAAM,OAAO,GAAG,mDAAmD,CAAC;AAEpE,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AAEH,4EAA4E;AAC5E,MAAM,iBAAiB,GAAG;IACxB,iBAAiB;IACjB,aAAa;IACb,WAAW;IACX,WAAW;IACX,UAAU;IACV,yBAAyB;IACzB,eAAe;CAChB,CAAC;AAEF,uDAAuD;AACvD,MAAM,gBAAgB,GAAG;IACvB,SAAS,EAAgB,uBAAuB;IAChD,SAAS,EAAgB,0FAA0F;IACnH,gBAAgB,EAAS,sDAAsD;IAC/E,iBAAiB,EAAQ,iDAAiD;IAC1E,iBAAiB,EAAS,qDAAqD;IAC/E,sBAAsB;IACtB,0BAA0B;IAC1B,cAAc;CACf,CAAC;AAEF,gCAAgC;AAChC,MAAM,gBAAgB,GAAG;IACvB,iCAAiC;IACjC,qCAAqC;IACrC,6BAA6B;IAC7B,iBAAiB;CAClB,CAAC;AAEF,+BAA+B;AAC/B,MAAM,cAAc,GAAG;IACrB,WAAW;IACX,cAAc;IACd,qBAAqB;IACrB,oBAAoB;IACpB,oBAAoB;IACpB,4BAA4B;CAC7B,CAAC;AAEF,MAAa,aAAc,SAAQ,yBAAW;IAA9C;;QACW,cAAS,GAAG,QAAQ,CAAC;IAkChC,CAAC;IAhCC,UAAU,CAAC,eAAyB;QAClC,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,IAAI,EAAE,eAAe;YACrB,iEAAiE;SAClE,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,GAAW,EAAE,aAA4B;QACpD,2DAA2D;QAC3D,IAAI,aAAa,KAAK,WAAW;YAAE,OAAO,IAAI,CAAC;QAE/C,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAE5B,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,iBAAiB,CAAC;YAAE,OAAO,mBAAmB,CAAC;QACtE,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC;YAAE,OAAO,OAAO,CAAC;QACvD,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,gBAAgB,CAAC;YAAE,OAAO,mBAAmB,CAAC;QAErE,+DAA+D;QAC/D,IACE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,gBAAgB,CAAC;YACpC,CAAC,aAAa,KAAK,mBAAmB,IAAI,aAAa,KAAK,mBAAmB,CAAC,EAChF,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,OAAO,CAAC,IAAY,EAAE,QAAkB;QAC9C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,CAAC;CACF;AAnCD,sCAmCC"}

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const runSession_1 = require("./runner/runSession");
+const claudeAdapter_1 = require("./adapters/claudeAdapter");
+const ntfyNotifier_1 = require("./notifications/ntfyNotifier");
+// ── ANSI helpers ─────────────────────────────────────────────────────────────
+const DIM = '\x1b[2m';
+const RESET = '\x1b[0m';
+const CYAN = '\x1b[36m';
+const YELLOW = '\x1b[33m';
+const RED = '\x1b[31m';
+const GREEN = '\x1b[32m';
+function timestamp() {
+    return new Date().toISOString().split('T')[1].replace('Z', '');
+}
+// ── Event handler factory ────────────────────────────────────────────────────
+// Returns an onEvent callback. Logs to stderr and fires push notifications
+// when Claude needs attention.
+function makeEventHandler(sessionName, notifier) {
+    const tag = `${DIM}[ashral]${RESET}`;
+    const label = sessionName ? `"${sessionName}"` : 'session';
+    return function onEvent(event) {
+        // Raw output is already mirrored to stdout — skip it here
+        if (event.type === 'output')
+            return;
+        const ts = `${DIM}${timestamp()}${RESET}`;
+        switch (event.type) {
+            case 'status_changed': {
+                process.stderr.write(`\n${tag} ${ts} ${CYAN}status${RESET}  ${event.from} → ${event.to}\n`);
+                if (!notifier)
+                    break;
+                // Notify when Claude needs the user's attention
+                if (event.to === 'waiting_for_input') {
+                    notifier.send({
+                        title: `Ashral - ${label}`,
+                        body: 'Claude is waiting for your input.',
+                        priority: 'high',
+                    });
+                }
+                else if (event.to === 'approval_required') {
+                    notifier.send({
+                        title: `Ashral - ${label} [approval]`,
+                        body: 'Claude needs your approval before continuing.',
+                        priority: 'urgent',
+                    });
+                }
+                else if (event.to === 'error') {
+                    notifier.send({
+                        title: `Ashral - ${label} [error]`,
+                        body: 'Claude encountered an error.',
+                        priority: 'high',
+                    });
+                }
+                break;
+            }
+            case 'agent_prompt':
+                process.stderr.write(`${tag} ${ts} ${YELLOW}prompt${RESET}   ${event.prompt}\n`);
+                break;
+            case 'error':
+                process.stderr.write(`${tag} ${ts} ${RED}error${RESET}    ${event.message}\n`);
+                break;
+            case 'completed':
+                process.stderr.write(`\n${tag} ${ts} ${GREEN}done${RESET}     exit code ${event.exitCode}\n`);
+                break;
+        }
+    };
+}
+// ── Notifier setup ────────────────────────────────────────────────────────────
+// Resolves a notifier from --notify-url flag or ASHRAL_NTFY_URL env var.
+// Returns null (silent) if neither is set.
+function resolveNotifier(flagUrl) {
+    const url = flagUrl ?? process.env.ASHRAL_NTFY_URL;
+    if (!url)
+        return null;
+    return new ntfyNotifier_1.NtfyNotifier(url);
+}
+// ── CLI definition ────────────────────────────────────────────────────────────
+const program = new commander_1.Command();
+program
+    .name('ashral')
+    .description('Control center for AI coding agents')
+    .version('0.1.0');
+const runCmd = program.command('run').description('Run an AI coding agent');
+runCmd
+    .command('claude')
+    .description('Start a Claude Code session')
+    .option('--name <name>', 'human-readable session name')
+    .option('--notify-url <url>', 'ntfy.sh topic URL for push notifications (or set ASHRAL_NTFY_URL)')
+    .allowUnknownOption()
+    .allowExcessArguments()
+    .action(async (options, command) => {
+    const passthroughArgs = command.args;
+    const adapter = new claudeAdapter_1.ClaudeAdapter();
+    const notifier = resolveNotifier(options.notifyUrl);
+    if (options.name) {
+        process.stderr.write(`\n[ashral] Starting session: ${options.name}\n`);
+    }
+    if (notifier) {
+        process.stderr.write(`[ashral] Push notifications enabled.\n`);
+    }
+    process.stderr.write('\n');
+    try {
+        await (0, runSession_1.runSession)({
+            adapter,
+            name: options.name,
+            passthroughArgs,
+            onEvent: makeEventHandler(options.name, notifier),
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ashral] Fatal: ${message}\n`);
+        process.exit(1);
+    }
+});
+program.parse(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/notifications/notifier.d.ts

@@ -0,0 +1,16 @@
+export interface NotificationPayload {
+    title: string;
+    body: string;
+    /** Optional urgency hint — providers map this to their own priority scale */
+    priority?: 'low' | 'normal' | 'high' | 'urgent';
+    /** Optional deep-link or action URL */
+    url?: string;
+}
+/**
+ * Minimal interface every push provider must satisfy.
+ * Implementations should be fire-and-forget (errors logged, never thrown).
+ */
+export interface Notifier {
+    send(payload: NotificationPayload): Promise<void>;
+}
+//# sourceMappingURL=notifier.d.ts.map

package/dist/notifications/notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.d.ts","sourceRoot":"","sources":["../../src/notifications/notifier.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IAChD,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD"}

package/dist/notifications/notifier.js

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

package/dist/notifications/notifier.js.map

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

package/dist/notifications/ntfyNotifier.d.ts

@@ -0,0 +1,7 @@
+import type { Notifier, NotificationPayload } from './notifier';
+export declare class NtfyNotifier implements Notifier {
+    private readonly url;
+    constructor(url: string);
+    send(payload: NotificationPayload): Promise<void>;
+}
+//# sourceMappingURL=ntfyNotifier.d.ts.map

package/dist/notifications/ntfyNotifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ntfyNotifier.d.ts","sourceRoot":"","sources":["../../src/notifications/ntfyNotifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AA4BhE,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,EAAE,MAAM;IAIjB,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CA6BxD"}

package/dist/notifications/ntfyNotifier.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NtfyNotifier = void 0;
+// ntfy.sh priority values: https://docs.ntfy.sh/publish/#message-priority
+const PRIORITY_MAP = {
+    low: '2',
+    normal: '3',
+    high: '4',
+    urgent: '5',
+};
+/**
+ * Sends push notifications via ntfy.sh (or any self-hosted ntfy instance).
+ *
+ * Setup:
+ *   1. Install the ntfy app on your phone (iOS / Android — free).
+ *   2. Pick a topic name — something unguessable like "ashral-simon-7x3k".
+ *   3. Subscribe to that topic in the app.
+ *   4. Set ASHRAL_NTFY_URL=https://ntfy.sh/<your-topic>  (or pass it to the constructor).
+ *
+ * No account required for public topics on ntfy.sh.
+ * For privacy, run a self-hosted ntfy instance and point the URL there.
+ */
+// HTTP headers must be Latin-1 (ISO-8859-1). Strip anything outside that range
+// so unicode chars like em dashes don't cause a ByteString conversion error.
+function toHeaderSafeAscii(str) {
+    return str.replace(/[^\x00-\xFF]/g, '').trim();
+}
+class NtfyNotifier {
+    constructor(url) {
+        this.url = url;
+    }
+    async send(payload) {
+        const headers = {
+            'Content-Type': 'text/plain; charset=utf-8',
+            'Title': toHeaderSafeAscii(payload.title),
+            'Priority': PRIORITY_MAP[payload.priority ?? 'normal'],
+        };
+        if (payload.url) {
+            headers['Actions'] = `view, Open, ${payload.url}`;
+        }
+        try {
+            const res = await fetch(this.url, {
+                method: 'POST',
+                headers,
+                body: payload.body,
+            });
+            if (!res.ok) {
+                process.stderr.write(`[ashral] ntfy notification failed: HTTP ${res.status} ${res.statusText}\n`);
+            }
+        }
+        catch (err) {
+            // Never let a notification failure crash the session
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`[ashral] ntfy notification error: ${msg}\n`);
+        }
+    }
+}
+exports.NtfyNotifier = NtfyNotifier;
+//# sourceMappingURL=ntfyNotifier.js.map

package/dist/notifications/ntfyNotifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ntfyNotifier.js","sourceRoot":"","sources":["../../src/notifications/ntfyNotifier.ts"],"names":[],"mappings":";;;AAEA,0EAA0E;AAC1E,MAAM,YAAY,GAAiE;IACjF,GAAG,EAAE,GAAG;IACR,MAAM,EAAE,GAAG;IACX,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,GAAG;CACZ,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,+EAA+E;AAC/E,6EAA6E;AAC7E,SAAS,iBAAiB,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,MAAa,YAAY;IAGvB,YAAY,GAAW;QACrB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAA4B;QACrC,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,2BAA2B;YAC3C,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC;YACzC,UAAU,EAAE,YAAY,CAAC,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC;SACvD,CAAC;QAEF,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,OAAO,CAAC,SAAS,CAAC,GAAG,eAAe,OAAO,CAAC,GAAG,EAAE,CAAC;QACpD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC,CAAC;YAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2CAA2C,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,IAAI,CAC5E,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,qDAAqD;YACrD,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,GAAG,IAAI,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF;AApCD,oCAoCC"}

package/dist/runner/runSession.d.ts

@@ -0,0 +1,15 @@
+import type { BaseAdapter } from '../adapters/baseAdapter';
+import type { AshralEvent } from '../types/events';
+export interface RunSessionOptions {
+    adapter: BaseAdapter;
+    name?: string;
+    /** Extra args forwarded verbatim to the agent CLI (everything after --) */
+    passthroughArgs: string[];
+    onEvent: (event: AshralEvent) => void;
+}
+/**
+ * Spawns the agent inside a PTY, bridges all I/O, and drives the session
+ * state machine. Resolves when the agent process exits.
+ */
+export declare function runSession(options: RunSessionOptions): Promise<void>;
+//# sourceMappingURL=runSession.d.ts.map

package/dist/runner/runSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runSession.d.ts","sourceRoot":"","sources":["../../src/runner/runSession.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyF1E"}

package/dist/runner/runSession.js

@@ -0,0 +1,120 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSession = runSession;
+const pty = __importStar(require("node-pty"));
+const sessionState_1 = require("./sessionState");
+/**
+ * Spawns the agent inside a PTY, bridges all I/O, and drives the session
+ * state machine. Resolves when the agent process exits.
+ */
+async function runSession(options) {
+    const { adapter, name, passthroughArgs, onEvent } = options;
+    const cwd = process.cwd();
+    const { columns = 80, rows = 24 } = process.stdout;
+    const state = new sessionState_1.SessionState(adapter.agentName, name, cwd, onEvent);
+    const config = adapter.getCommand(passthroughArgs);
+    // Merge adapter env overrides on top of the current environment
+    const env = { ...process.env, ...(config.env ?? {}) };
+    const term = pty.spawn(config.command, config.args, {
+        name: 'xterm-color',
+        cols: columns,
+        rows,
+        cwd,
+        env,
+    });
+    state.transition('running');
+    // ── Output: mirror PTY → stdout, inspect for state changes ─────────────────
+    term.onData((data) => {
+        // Write raw (ANSI-preserved) data so the terminal renders correctly
+        process.stdout.write(data);
+        onEvent({
+            type: 'output',
+            sessionId: state.id,
+            timestamp: new Date(),
+            data,
+        });
+        const next = adapter.detectStatus(data, state.status);
+        if (next !== null) {
+            state.transition(next);
+        }
+    });
+    // ── Input: forward stdin → PTY ──────────────────────────────────────────────
+    // Raw mode disables line buffering and lets control characters (Ctrl+C etc.)
+    // pass through as data to the PTY rather than being handled by Node.
+    const isTTY = process.stdin.isTTY ?? false;
+    if (isTTY)
+        process.stdin.setRawMode(true);
+    process.stdin.resume();
+    const onStdinData = (chunk) => term.write(chunk.toString('binary'));
+    process.stdin.on('data', onStdinData);
+    // ── Resize: keep PTY columns/rows in sync with the terminal ─────────────────
+    const onResize = () => {
+        const { columns: cols = 80, rows: r = 24 } = process.stdout;
+        term.resize(cols, r);
+    };
+    process.stdout.on('resize', onResize);
+    // ── Cleanup helper ───────────────────────────────────────────────────────────
+    function teardown() {
+        process.stdin.removeListener('data', onStdinData);
+        process.stdout.removeListener('resize', onResize);
+        if (isTTY)
+            process.stdin.setRawMode(false);
+        process.stdin.pause();
+    }
+    return new Promise((resolve, reject) => {
+        term.onExit(({ exitCode, signal }) => {
+            teardown();
+            if (signal && exitCode !== 0) {
+                // Process was killed by a signal — surface as an error event
+                onEvent({
+                    type: 'error',
+                    sessionId: state.id,
+                    timestamp: new Date(),
+                    message: `Agent killed by signal ${signal}`,
+                });
+                state.transition('error');
+            }
+            state.complete(exitCode);
+            resolve();
+        });
+        // Catch spawn errors (e.g. command not found)
+        process.nextTick(() => {
+            // node-pty doesn't emit an 'error' event; spawn failures surface as
+            // immediate exits with code 127 or throw synchronously — handled above.
+        });
+    });
+}
+//# sourceMappingURL=runSession.js.map

package/dist/runner/runSession.js.map

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

package/dist/runner/sessionState.d.ts

@@ -0,0 +1,15 @@
+import type { Session, SessionStatus } from '../types/session';
+import type { AshralEvent } from '../types/events';
+export declare class SessionState {
+    private session;
+    private readonly emit;
+    constructor(agent: string, name: string | undefined, cwd: string, emit: (event: AshralEvent) => void);
+    get id(): string;
+    get status(): SessionStatus;
+    /** Transition to a new status and emit a status_changed event. No-ops on same status. */
+    transition(to: SessionStatus): void;
+    /** Mark the session as done. Sets endedAt and transitions to completed. */
+    complete(exitCode: number): void;
+    snapshot(): Readonly<Session>;
+}
+//# sourceMappingURL=sessionState.d.ts.map

package/dist/runner/sessionState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionState.d.ts","sourceRoot":"","sources":["../../src/runner/sessionState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,iBAAiB,CAAC;AAEvE,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;gBAGlD,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;IAapC,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,MAAM,IAAI,aAAa,CAE1B;IAED,yFAAyF;IACzF,UAAU,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;IAgBnC,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAWhC,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC;CAG9B"}

package/dist/runner/sessionState.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionState = void 0;
+const crypto_1 = require("crypto");
+class SessionState {
+    constructor(agent, name, cwd, emit) {
+        this.emit = emit;
+        this.session = {
+            id: (0, crypto_1.randomUUID)(),
+            name,
+            agent,
+            status: 'starting',
+            startedAt: new Date(),
+            cwd,
+        };
+    }
+    get id() {
+        return this.session.id;
+    }
+    get status() {
+        return this.session.status;
+    }
+    /** Transition to a new status and emit a status_changed event. No-ops on same status. */
+    transition(to) {
+        const from = this.session.status;
+        if (from === to)
+            return;
+        this.session.status = to;
+        const event = {
+            type: 'status_changed',
+            sessionId: this.session.id,
+            timestamp: new Date(),
+            from,
+            to,
+        };
+        this.emit(event);
+    }
+    /** Mark the session as done. Sets endedAt and transitions to completed. */
+    complete(exitCode) {
+        this.session.endedAt = new Date();
+        this.transition('completed');
+        this.emit({
+            type: 'completed',
+            sessionId: this.session.id,
+            timestamp: new Date(),
+            exitCode,
+        });
+    }
+    snapshot() {
+        return { ...this.session };
+    }
+}
+exports.SessionState = SessionState;
+//# sourceMappingURL=sessionState.js.map

package/dist/runner/sessionState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionState.js","sourceRoot":"","sources":["../../src/runner/sessionState.ts"],"names":[],"mappings":";;;AAAA,mCAAoC;AAIpC,MAAa,YAAY;IAIvB,YACE,KAAa,EACb,IAAwB,EACxB,GAAW,EACX,IAAkC;QAElC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG;YACb,EAAE,EAAE,IAAA,mBAAU,GAAE;YAChB,IAAI;YACJ,KAAK;YACL,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,GAAG;SACJ,CAAC;IACJ,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IACzB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,yFAAyF;IACzF,UAAU,CAAC,EAAiB;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACjC,IAAI,IAAI,KAAK,EAAE;YAAE,OAAO;QAExB,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC;QAEzB,MAAM,KAAK,GAAuB;YAChC,IAAI,EAAE,gBAAgB;YACtB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE;YAC1B,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,IAAI;YACJ,EAAE;SACH,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,2EAA2E;IAC3E,QAAQ,CAAC,QAAgB;QACvB,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE;YAC1B,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;CACF;AA7DD,oCA6DC"}

package/dist/types/events.d.ts

@@ -0,0 +1,31 @@
+import type { SessionStatus } from './session';
+export type EventType = 'output' | 'status_changed' | 'agent_prompt' | 'error' | 'completed';
+interface BaseEvent {
+    type: EventType;
+    sessionId: string;
+    timestamp: Date;
+}
+export interface OutputEvent extends BaseEvent {
+    type: 'output';
+    data: string;
+}
+export interface StatusChangedEvent extends BaseEvent {
+    type: 'status_changed';
+    from: SessionStatus;
+    to: SessionStatus;
+}
+export interface AgentPromptEvent extends BaseEvent {
+    type: 'agent_prompt';
+    prompt: string;
+}
+export interface ErrorEvent extends BaseEvent {
+    type: 'error';
+    message: string;
+}
+export interface CompletedEvent extends BaseEvent {
+    type: 'completed';
+    exitCode: number;
+}
+export type AshralEvent = OutputEvent | StatusChangedEvent | AgentPromptEvent | ErrorEvent | CompletedEvent;
+export {};
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,gBAAgB,GAChB,cAAc,GACd,OAAO,GACP,WAAW,CAAC;AAEhB,UAAU,SAAS;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,IAAI,EAAE,QAAQ,CAAC;IAEf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,aAAa,CAAC;CACnB;AAGD,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,kBAAkB,GAClB,gBAAgB,GAChB,UAAU,GACV,cAAc,CAAC"}

package/dist/types/events.js

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

package/dist/types/events.js.map

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

package/dist/types/session.d.ts

@@ -0,0 +1,11 @@
+export type SessionStatus = 'starting' | 'running' | 'waiting_for_input' | 'approval_required' | 'error' | 'completed';
+export interface Session {
+    id: string;
+    name?: string;
+    agent: string;
+    status: SessionStatus;
+    startedAt: Date;
+    endedAt?: Date;
+    cwd: string;
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,SAAS,GACT,mBAAmB,GACnB,mBAAmB,GACnB,OAAO,GACP,WAAW,CAAC;AAEhB,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/types/session.js

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

package/dist/types/session.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "ashral",
+  "version": "0.1.0",
+  "description": "Control center for AI coding agents",
+  "main": "dist/cli.js",
+  "bin": {
+    "ashral": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "scripts/postinstall.js"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/cli.ts",
+    "start": "node dist/cli.js",
+    "clean": "rm -rf dist",
+    "prepare": "tsc",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "node-pty": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+// Fixes missing execute bit on node-pty prebuilt binaries.
+// npm strips +x from native files on install — this restores it.
+// No-op on Windows (spawn-helper is not used there).
+
+const { chmodSync, existsSync } = require('fs');
+const { join } = require('path');
+
+if (process.platform === 'win32') process.exit(0);
+
+const platformKey = `${process.platform}-${process.arch}`;
+const prebuildDir = join(__dirname, '..', 'node_modules', 'node-pty', 'prebuilds', platformKey);
+
+for (const file of ['spawn-helper', 'pty.node']) {
+  const filePath = join(prebuildDir, file);
+  if (existsSync(filePath)) {
+    try {
+      chmodSync(filePath, 0o755);
+    } catch (_) {
+      // Best-effort — don't fail the install
+    }
+  }
+}