pi-amq 0.1.1

package/dist/integration/confirmed-bind-onboarding.js

@@ -0,0 +1,199 @@
+import { isAbsolute, normalize } from "node:path";
+import { BindingResolver, } from "../transport/binding-resolver.js";
+/** Owns the confirmation-gated first-run boundary; it never guesses authority. */
+export class ConfirmedBindOnboarding {
+    #runner;
+    #resolver;
+    constructor(runner, resolver = new BindingResolver(runner)) {
+        this.#runner = runner;
+        this.#resolver = resolver;
+    }
+    async preview(request) {
+        const projectDirectory = absolute(request.projectDirectory, "project directory");
+        const root = absolute(request.root, "AMQ root");
+        const handle = agentHandle(request.handle, "chosen handle");
+        const requestedAgents = roster(request.agents, handle);
+        const environment = request.environment ?? process.env;
+        const who = await this.#runner.runJson(["who", "--root", root], { env: commandEnvironment(environment), parse: parseWho });
+        if (who.ok && who.json?.initialized) {
+            const existingAgents = unique(who.json.sessions.flatMap((session) => session.agents.map((agent) => agent.handle)));
+            if (!existingAgents.includes(handle)) {
+                throw new Error(`Chosen handle ${handle} is not provisioned in the existing AMQ roster: ${existingAgents.join(",")}`);
+            }
+            const live = await this.#runner.runJson(["env", "--root", root, "--me", handle], { env: commandEnvironment(environment), parse: parseEnvPreview });
+            if (!live.ok || !live.json) {
+                throw new Error(literalFailure(live, "Existing AMQ root could not be inspected"));
+            }
+            return {
+                kind: "existing",
+                projectDirectory,
+                root: live.json.root,
+                session: live.json.session,
+                project: live.json.project,
+                handle,
+                agents: existingAgents,
+                command: [],
+                commandText: "No initialization command; verify and bind the selected existing mailbox",
+                effects: ["Persist pi-amq-binding/v1 only after live mailbox verification"],
+            };
+        }
+        if (!(who.ok && who.json && !who.json.initialized) && !bootstrapEligible(who)) {
+            throw new Error(literalFailure(who, "AMQ roster discovery failed"));
+        }
+        const command = ["amq", "coop", "init", "--root", root, "--agents", requestedAgents.join(",")];
+        return {
+            kind: "bootstrap",
+            projectDirectory,
+            root,
+            session: "",
+            project: projectDirectory,
+            handle,
+            agents: requestedAgents,
+            command,
+            commandText: command.map(shellWord).join(" "),
+            effects: [
+                `Create the physical AMQ root at ${root}`,
+                `Provision the complete roster: ${requestedAgents.join(",")}`,
+                `Write ${projectDirectory}/.amqrc`,
+                `Update ${projectDirectory}/.gitignore when needed`,
+            ],
+        };
+    }
+    async confirm(preview, confirmed, environment = process.env) {
+        if (!confirmed)
+            return { kind: "cancelled", diagnostic: "AMQ bind cancelled; no state changed" };
+        if (preview.kind === "bootstrap") {
+            const initialized = await this.#runner.runJson(preview.command.slice(1), { cwd: preview.projectDirectory, env: commandEnvironment(environment) });
+            if (!initialized.ok) {
+                return {
+                    kind: "refused",
+                    diagnostic: literalFailure(initialized, "AMQ roster bootstrap failed; pi-amq remains dormant"),
+                };
+            }
+        }
+        const resolution = await this.#resolver.resolve({
+            flags: { handle: preview.handle, root: preview.root },
+            environment: clearInheritedBinding(environment),
+        });
+        if (resolution.kind !== "bound")
+            return refusedResolution(resolution);
+        if (resolution.binding.root !== preview.root || resolution.binding.handle !== preview.handle) {
+            return {
+                kind: "refused",
+                diagnostic: "Post-provision binding differs from the confirmed root or handle; pi-amq remains dormant",
+            };
+        }
+        const who = await this.#runner.runJson(["who", "--root", preview.root], { env: commandEnvironment(environment), parse: parseWho });
+        if (!who.ok || !who.json?.initialized) {
+            return {
+                kind: "refused",
+                diagnostic: literalFailure(who, "Post-provision roster verification failed; pi-amq remains dormant"),
+            };
+        }
+        const verifiedAgents = unique(who.json.sessions.flatMap((session) => session.agents.map((agent) => agent.handle)));
+        if (!sameRoster(verifiedAgents, preview.agents)) {
+            return {
+                kind: "refused",
+                diagnostic: `Post-provision roster mismatch: confirmed ${preview.agents.join(",")}; live ${verifiedAgents.join(",")}`,
+            };
+        }
+        return { kind: "bound", binding: resolution.binding };
+    }
+}
+export function parseRosterInput(value, handle) {
+    return roster(value.split(","), agentHandle(handle, "chosen handle"));
+}
+function parseWho(value) {
+    if (value === null)
+        return { initialized: false, sessions: [] };
+    if (!Array.isArray(value))
+        throw new Error("amq who --json must return an array");
+    const sessions = value.map((rawSession, sessionIndex) => {
+        const session = record(rawSession, `amq who session ${sessionIndex}`);
+        if (!Array.isArray(session.agents))
+            throw new Error("amq who session agents must be an array");
+        return {
+            name: stringField(session, "name"),
+            agents: session.agents.map((rawAgent, agentIndex) => {
+                const agent = record(rawAgent, `amq who agent ${agentIndex}`);
+                return { handle: agentHandle(stringField(agent, "handle"), "AMQ roster handle") };
+            }),
+        };
+    });
+    return { initialized: true, sessions };
+}
+function parseEnvPreview(value) {
+    const object = record(value, "amq env --json");
+    return {
+        root: absolute(stringField(object, "root"), "live AMQ root"),
+        session: stringField(object, "session_name"),
+        project: stringField(object, "project"),
+    };
+}
+function bootstrapEligible(result) {
+    return result.category === "not-found"
+        || (result.category === "error" && /(?:not initialized|missing|not found|no such file)/i.test(result.stderr));
+}
+function refusedResolution(resolution) {
+    return {
+        kind: "refused",
+        diagnostic: `${resolution.diagnostic}; pi-amq remains dormant`,
+    };
+}
+function roster(values, handle) {
+    const normalized = values
+        .flatMap((value) => value.split(","))
+        .map((value) => value.trim())
+        .filter((value) => value.length > 0)
+        .map((value) => agentHandle(value, "roster handle"));
+    return unique([...normalized, handle, "user"]);
+}
+function unique(values) {
+    return [...new Set(values)].sort((left, right) => left.localeCompare(right));
+}
+function sameRoster(left, right) {
+    const normalizedLeft = unique(left);
+    const normalizedRight = unique(right);
+    return normalizedLeft.length === normalizedRight.length
+        && normalizedLeft.every((value, index) => value === normalizedRight[index]);
+}
+function absolute(value, name) {
+    if (!isAbsolute(value))
+        throw new TypeError(`${name} must be absolute`);
+    return normalize(value);
+}
+function agentHandle(value, name) {
+    const normalized = value.trim();
+    if (!/^[a-z0-9][a-z0-9._-]*$/.test(normalized)) {
+        throw new TypeError(`${name} must use lowercase AMQ handle syntax`);
+    }
+    return normalized;
+}
+function clearInheritedBinding(environment) {
+    const cleared = { ...environment };
+    for (const key of ["AM_ROOT", "AM_ROOT_ID", "AM_BASE_ROOT", "AM_BASE_ROOT_ID", "AM_SESSION", "AM_ME"]) {
+        delete cleared[key];
+    }
+    return cleared;
+}
+function commandEnvironment(environment) {
+    return { ...environment };
+}
+function shellWord(value) {
+    return /^[A-Za-z0-9_./,:=-]+$/.test(value) ? value : `'${value.replaceAll("'", `'\"'\"'`)}'`;
+}
+function literalFailure(result, fallback) {
+    return result.stderr.trim() || result.jsonError?.message || result.processError?.message || fallback;
+}
+function record(value, name) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error(`${name} must be an object`);
+    return value;
+}
+function stringField(object, key) {
+    const value = object[key];
+    if (typeof value !== "string")
+        throw new Error(`${key} must be a string`);
+    return value;
+}
+//# sourceMappingURL=confirmed-bind-onboarding.js.map

package/dist/integration/confirmed-bind-onboarding.js.map

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

package/dist/integration/fleet-view.d.ts

@@ -0,0 +1,66 @@
+export type FleetLifecycle = "idle" | "busy" | "paused" | "offline" | "ambiguous";
+export interface FleetAgentRecord {
+    readonly id: string;
+    readonly handle: string;
+    readonly role: string;
+    readonly model: string;
+    readonly state: FleetLifecycle;
+    readonly spend: number | null;
+    readonly lastActivity: string;
+    readonly mode: "main" | "rpc" | "json";
+    readonly generation?: string;
+    readonly conversation?: readonly string[];
+}
+export interface FleetProjectionSource {
+    snapshot(): readonly FleetAgentRecord[];
+    subscribe(listener: () => void): () => void;
+}
+export declare class MutableFleetProjectionSource implements FleetProjectionSource {
+    #private;
+    constructor(initial: readonly FleetAgentRecord[]);
+    snapshot(): readonly FleetAgentRecord[];
+    update(records: readonly FleetAgentRecord[]): void;
+    subscribe(listener: () => void): () => void;
+}
+export declare class FleetListModel {
+    #private;
+    constructor(source: FleetProjectionSource, invalidate: () => void);
+    get invalidations(): number;
+    get selected(): FleetAgentRecord | undefined;
+    get open(): boolean;
+    focus(): void;
+    close(): void;
+    move(delta: -1 | 1): void;
+    render(): string[];
+    dispose(): void;
+}
+export type FleetInputAction = {
+    readonly consume: false;
+} | {
+    readonly consume: true;
+    readonly action: "focus" | "move" | "detail" | "close";
+};
+export declare function handleFleetInput(options: {
+    readonly data: string;
+    readonly editorText: string;
+    readonly list: FleetListModel;
+}): FleetInputAction;
+export declare function renderFleetDetail(record: FleetAgentRecord): string[];
+export declare function canSteerFleetRecord(record: FleetAgentRecord, currentGeneration: string | undefined): boolean;
+export type FleetControlStatus = "idle" | "composing" | "requested" | "observed" | "indeterminate";
+export declare class FleetDetailController {
+    #private;
+    constructor(options: {
+        readonly record: FleetAgentRecord;
+        readonly resolve: () => FleetAgentRecord | undefined;
+        readonly steer: (recordId: string, generation: string, message: string) => Promise<void>;
+        readonly cancel: (recordId: string, generation: string) => Promise<void>;
+    });
+    get status(): FleetControlStatus;
+    render(): string[];
+    handleInput(data: string): {
+        readonly close: boolean;
+        readonly consumed: boolean;
+    };
+}
+//# sourceMappingURL=fleet-view.d.ts.map

package/dist/integration/fleet-view.d.ts.map

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

package/dist/integration/fleet-view.js

@@ -0,0 +1,238 @@
+/*
+ * SPDX-License-Identifier: MIT
+ * Structural interaction pattern adapted from ZiChuanLan/pi-subagents-lite,
+ * itself forked from @tintinweb/pi-subagents v0.14.2.
+ * Copyright (c) 2026 tintinweb
+ * Copyright (c) 2026 lan
+ * Modified for pi-amq: render-only authoritative projection; no AgentManager.
+ */
+export class MutableFleetProjectionSource {
+    #records;
+    #listeners = new Set();
+    constructor(initial) {
+        this.#records = [...initial];
+    }
+    snapshot() {
+        return this.#records.map((record) => ({ ...record }));
+    }
+    update(records) {
+        this.#records = [...records];
+        for (const listener of this.#listeners)
+            listener();
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+}
+export class FleetListModel {
+    #source;
+    #selected = 0;
+    #open = false;
+    #invalidations = 0;
+    #unsubscribe;
+    constructor(source, invalidate) {
+        this.#source = source;
+        this.#unsubscribe = source.subscribe(() => {
+            const last = Math.max(0, this.#source.snapshot().length - 1);
+            this.#selected = Math.min(this.#selected, last);
+            this.#invalidations += 1;
+            invalidate();
+        });
+    }
+    get invalidations() {
+        return this.#invalidations;
+    }
+    get selected() {
+        return this.#source.snapshot()[this.#selected];
+    }
+    get open() {
+        return this.#open;
+    }
+    focus() {
+        this.#open = true;
+    }
+    close() {
+        this.#open = false;
+    }
+    move(delta) {
+        const count = this.#source.snapshot().length;
+        if (count === 0)
+            return;
+        this.#selected = Math.max(0, Math.min(count - 1, this.#selected + delta));
+    }
+    render() {
+        const records = this.#source.snapshot();
+        if (records.length === 0)
+            return ["Fleet: no active sessions"];
+        return [
+            "Fleet",
+            ...records.map((record, index) => {
+                const marker = this.#open && index === this.#selected ? ">" : " ";
+                const spend = record.spend === null ? "-" : `$${record.spend.toFixed(4)}`;
+                return `${marker} ${record.handle}/${record.role} ${record.model} ${record.state} ${spend} ${record.lastActivity}`;
+            }),
+        ];
+    }
+    dispose() {
+        this.#unsubscribe();
+    }
+}
+export function handleFleetInput(options) {
+    if (options.editorText !== "")
+        return { consume: false };
+    const { data, list } = options;
+    if (!list.open && isDown(data)) {
+        list.focus();
+        return { consume: true, action: "focus" };
+    }
+    if (!list.open)
+        return { consume: false };
+    if (isDown(data)) {
+        list.move(1);
+        return { consume: true, action: "move" };
+    }
+    if (isUp(data)) {
+        list.move(-1);
+        return { consume: true, action: "move" };
+    }
+    if (data === "\r" || data === "\n")
+        return { consume: true, action: "detail" };
+    if (data === "\u001b") {
+        list.close();
+        return { consume: true, action: "close" };
+    }
+    return { consume: false };
+}
+export function renderFleetDetail(record) {
+    return [
+        `${record.handle}/${record.role} (${record.state})`,
+        `model=${record.model} activity=${record.lastActivity}`,
+        ...(record.mode === "json" ? ["one-shot worker, cannot steer"] : []),
+        "",
+        ...(record.conversation ?? ["No conversation projection available."]),
+    ];
+}
+export function canSteerFleetRecord(record, currentGeneration) {
+    return record.mode === "rpc"
+        && record.generation !== undefined
+        && record.generation === currentGeneration;
+}
+export class FleetDetailController {
+    #recordId;
+    #generation;
+    #resolve;
+    #steer;
+    #cancel;
+    #composer = "";
+    #status = "idle";
+    #diagnostic = "";
+    #xArmed = false;
+    constructor(options) {
+        this.#recordId = options.record.id;
+        this.#generation = options.record.generation;
+        this.#resolve = options.resolve;
+        this.#steer = options.steer;
+        this.#cancel = options.cancel;
+    }
+    get status() {
+        return this.#status;
+    }
+    render() {
+        const record = this.#resolve();
+        if (!record)
+            return ["Worker projection disappeared.", "control=indeterminate"];
+        const controls = record.mode === "rpc"
+            ? ["Enter: compose steer · x,x: stop · Esc: close"]
+            : ["one-shot worker, cannot steer", "x,x: stop · Esc: close"];
+        return [
+            ...renderFleetDetail(record),
+            "",
+            ...controls,
+            ...(this.#status === "composing" ? [`steer> ${this.#composer}`] : []),
+            ...(this.#status === "idle" ? [] : [`control=${this.#status}${this.#diagnostic ? `: ${this.#diagnostic}` : ""}`]),
+        ];
+    }
+    handleInput(data) {
+        if (data === "\u001b") {
+            if (this.#status === "composing") {
+                this.#composer = "";
+                this.#status = "idle";
+                return { close: false, consumed: true };
+            }
+            return { close: true, consumed: true };
+        }
+        if (this.#status === "composing") {
+            if (data === "\r" || data === "\n") {
+                const message = this.#composer.trim();
+                this.#composer = "";
+                if (message)
+                    void this.#request("steer", message);
+                else
+                    this.#status = "idle";
+                return { close: false, consumed: true };
+            }
+            if (data === "\u007f")
+                this.#composer = this.#composer.slice(0, -1);
+            else if (!data.startsWith("\u001b"))
+                this.#composer += data;
+            return { close: false, consumed: true };
+        }
+        if (data === "\r" || data === "\n") {
+            const record = this.#resolve();
+            if (record?.mode === "rpc" && this.#isGenerationCurrent(record)) {
+                this.#status = "composing";
+            }
+            else {
+                this.#status = "indeterminate";
+                this.#diagnostic = record?.mode === "json"
+                    ? "one-shot worker, cannot steer"
+                    : "worker generation changed";
+            }
+            return { close: false, consumed: true };
+        }
+        if (data === "x") {
+            if (this.#xArmed) {
+                this.#xArmed = false;
+                void this.#request("cancel");
+            }
+            else {
+                this.#xArmed = true;
+            }
+            return { close: false, consumed: true };
+        }
+        this.#xArmed = false;
+        return { close: false, consumed: false };
+    }
+    #isGenerationCurrent(record) {
+        return this.#generation !== undefined && record.generation === this.#generation;
+    }
+    async #request(kind, message) {
+        const record = this.#resolve();
+        if (!record || !this.#isGenerationCurrent(record)) {
+            this.#status = "indeterminate";
+            this.#diagnostic = "worker generation changed";
+            return;
+        }
+        this.#status = "requested";
+        this.#diagnostic = kind;
+        try {
+            if (kind === "steer")
+                await this.#steer(this.#recordId, record.generation, message);
+            else
+                await this.#cancel(this.#recordId, record.generation);
+            this.#status = "observed";
+        }
+        catch (error) {
+            this.#status = "indeterminate";
+            this.#diagnostic = error instanceof Error ? error.message : String(error);
+        }
+    }
+}
+function isDown(data) {
+    return data === "\u001b[B";
+}
+function isUp(data) {
+    return data === "\u001b[A";
+}
+//# sourceMappingURL=fleet-view.js.map

package/dist/integration/fleet-view.js.map

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

package/dist/integration/fresh-session-dispatcher.d.ts

@@ -0,0 +1,66 @@
+import type { AmqMessage } from "../transport/amq-message.js";
+export interface FreshSessionProjectionEvidence {
+    readonly messageId: string;
+    readonly sessionId: string;
+    readonly diskVisible: boolean;
+}
+export interface FreshSessionCapabilityProbe {
+    probe(): Promise<{
+        readonly capable: true;
+    } | {
+        readonly capable: false;
+        readonly reason: string;
+        readonly dependencies: readonly string[];
+    }>;
+    dispatch(message: AmqMessage, signal?: AbortSignal, canReplaceSession?: (signal?: AbortSignal) => Promise<boolean>): Promise<FreshSessionProjectionEvidence>;
+}
+export interface FreshSessionReplacementPort {
+    waitForIdle(signal?: AbortSignal): Promise<void>;
+    replace(message: AmqMessage, signal?: AbortSignal): Promise<{
+        readonly cancelled: boolean;
+        readonly projection?: FreshSessionProjectionEvidence;
+    }>;
+}
+export declare class FreshSessionInterlockError extends Error {
+    constructor();
+}
+/** Full capable path; a real adapter must bind replace() to replacement-context-only session control. */
+export declare class CommandContextFreshSessionCapability implements FreshSessionCapabilityProbe {
+    #private;
+    constructor(port: FreshSessionReplacementPort);
+    probe(): Promise<{
+        readonly capable: true;
+    }>;
+    dispatch(message: AmqMessage, signal?: AbortSignal, canReplaceSession?: (signal?: AbortSignal) => Promise<boolean>): Promise<FreshSessionProjectionEvidence>;
+}
+export interface FreshSessionPolicy {
+    readonly trustedProject: boolean;
+    readonly allowlisted: (sender: string, project: string) => boolean;
+    readonly confirm?: (message: AmqMessage, signal?: AbortSignal) => Promise<boolean>;
+    readonly canReplaceSession: (signal?: AbortSignal) => Promise<boolean>;
+    readonly notifyOnce?: (message: string) => void;
+}
+export type FreshSessionDecision = {
+    readonly kind: "ordinary";
+} | {
+    readonly kind: "refused";
+    readonly reason: "not-authorized" | "worker-runtime-active";
+} | {
+    readonly kind: "pending";
+    readonly reason: string;
+    readonly action: "/amq ingest";
+} | {
+    readonly kind: "dispatched";
+    readonly projection: FreshSessionProjectionEvidence;
+};
+/** Serializes privileged session replacement behind explicit policy and capability ports. */
+export declare class FreshSessionDispatcher {
+    #private;
+    constructor(options: {
+        readonly capability: FreshSessionCapabilityProbe;
+        readonly policy: FreshSessionPolicy;
+    });
+    dispatch(message: AmqMessage, signal?: AbortSignal): Promise<FreshSessionDecision>;
+}
+export declare function requestsFreshSession(message: AmqMessage): boolean;
+//# sourceMappingURL=fresh-session-dispatcher.d.ts.map

package/dist/integration/fresh-session-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fresh-session-dispatcher.d.ts","sourceRoot":"","sources":["../../integration/fresh-session-dispatcher.ts"],"names":[],"mappings":"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"}