@maiaos/cli 0.1.0-canary.2

package/dist/session/attach.js

@@ -0,0 +1,106 @@
+import { initialSessionAttachView, sessionAttachCursor, } from "@maiaos/sdk";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Ref from "effect/Ref";
+import * as Stream from "effect/Stream";
+import { CliArgumentError, parseOptions, reportError, requirePositionals, } from "../command-line/index.js";
+import { finishSessionAttachRender, initialAttachRenderState, renderSessionAttachFrame, } from "./attach-render.js";
+const MAX_IDLE_REATTACHES = 5;
+const REATTACH_BACKOFF = Duration.millis(100);
+const NODE_UNAVAILABLE = {
+    code: "node_unavailable",
+    message: "The Session stream is unavailable.",
+    retryable: true,
+};
+export const readAttachCursor = (value) => {
+    if (value === undefined)
+        return undefined;
+    const separator = value.lastIndexOf(":");
+    const epoch = value.slice(0, separator);
+    const sequence = value.slice(separator + 1);
+    if (separator <= 0 ||
+        !/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/u.test(epoch) ||
+        !/^(?:0|[1-9]\d{0,15})$/u.test(sequence) ||
+        !Number.isSafeInteger(Number(sequence)))
+        throw new CliArgumentError("Option '--after' must be '<epoch>:<sequence>' from a previous attach.");
+    return { epoch, sequence: Number(sequence) };
+};
+const writeFrame = (attachment, frame) => Ref.modify(attachment.state, (state) => {
+    const rendered = renderSessionAttachFrame(state, frame);
+    return [rendered.text, rendered.state];
+}).pipe(Effect.map((text) => {
+    const { io, json } = attachment.context;
+    if (json)
+        io.stdout(`${JSON.stringify(frame)}\n`);
+    else if (text.length > 0)
+        io.stdout(text);
+}));
+const framesOf = (attachment, stream) => attachment.follow
+    ? stream
+    : stream.pipe(Stream.takeUntil((frame) => frame.kind === "synchronized"));
+const outcomeOf = (attachment, completed) => Ref.get(attachment.state).pipe(Effect.map(({ view }) => {
+    if (view.end?.kind === "error")
+        return {
+            error: {
+                code: view.end.code,
+                message: view.end.message,
+                retryable: false,
+            },
+            kind: "failed",
+        };
+    return completed && !attachment.follow
+        ? { kind: "ended" }
+        : { kind: "reattach" };
+}));
+const attachOnce = (attachment) => Effect.gen(function* () {
+    const { attachSession } = attachment.context.dependencies;
+    if (attachSession === undefined)
+        throw new CliArgumentError("Session attach is unavailable.");
+    const after = sessionAttachCursor((yield* Ref.get(attachment.state)).view);
+    const opened = yield* attachSession({
+        ...(after === undefined ? {} : { after }),
+        sessionId: attachment.sessionId,
+    });
+    if (!opened.ok)
+        return { error: opened.error, kind: "failed" };
+    const ran = yield* Effect.result(Stream.runForEach(framesOf(attachment, opened.value), (frame) => writeFrame(attachment, frame)));
+    return yield* outcomeOf(attachment, ran._tag === "Success");
+});
+const finish = (attachment, outcome) => Ref.get(attachment.state).pipe(Effect.map((state) => {
+    if (!attachment.context.json)
+        attachment.context.io.stdout(finishSessionAttachRender(state));
+    return outcome.kind === "failed"
+        ? reportError(outcome.error, attachment.context)
+        : 0;
+}));
+const follow = (attachment, idle) => Effect.gen(function* () {
+    const before = (yield* Ref.get(attachment.state)).view.sequence;
+    const outcome = yield* attachOnce(attachment);
+    if (outcome.kind !== "reattach")
+        return yield* finish(attachment, outcome);
+    const progressed = (yield* Ref.get(attachment.state)).view.sequence > before;
+    const nextIdle = progressed ? 0 : idle + 1;
+    if (nextIdle > MAX_IDLE_REATTACHES)
+        return yield* finish(attachment, {
+            error: NODE_UNAVAILABLE,
+            kind: "failed",
+        });
+    yield* Effect.sleep(Duration.times(REATTACH_BACKOFF, nextIdle));
+    return yield* follow(attachment, nextIdle);
+});
+export const runSessionAttach = (tokens, context) => Effect.gen(function* () {
+    const parsed = parseOptions(tokens, new Set(["--after"]), new Set(["--no-follow"]));
+    requirePositionals(parsed.positionals, 1);
+    const [sessionId = ""] = parsed.positionals;
+    const after = readAttachCursor(parsed.options.get("--after"));
+    const view = after === undefined
+        ? initialSessionAttachView
+        : { ...initialSessionAttachView, ...after };
+    return yield* follow({
+        context,
+        follow: !parsed.flags.has("--no-follow"),
+        sessionId,
+        state: yield* Ref.make(initialAttachRenderState(view)),
+    }, 0);
+});
+//# sourceMappingURL=attach.js.map

package/dist/session/client.d.ts

@@ -0,0 +1,132 @@
+import type { Session, SessionCreateParameters, SessionCreateResult, SessionCreationInput, SessionCreationOutcome, SessionCreationPlan, SessionEventsListResult, SessionInboxAckResult, SessionInboxCheckResult, SessionListParameters, SessionListResult, SessionMessageSendResult, SessionObserveResult, SessionResumeResult, SessionShowResult, SessionSpawnResult, SessionStartResult, SessionStopResult } from "@maiaos/sdk";
+import { type CliNodeEffect, type CliNodeOperations } from "../local-node/index.js";
+export type CreateSessionInput = {
+    readonly baseRef?: string;
+    readonly commandId?: string;
+    readonly connectionId?: string;
+    readonly definitionRef?: SessionCreateParameters["definitionRef"];
+    readonly executor?: SessionCreateParameters["executor"];
+    readonly model?: string;
+    readonly role?: SessionCreateParameters["role"];
+    readonly title?: string;
+    readonly workspaceId: string;
+};
+type SpawnSessionInput = {
+    readonly commandId?: string;
+    readonly harness: "maia-agent" | "pi";
+    readonly parentSessionId: string;
+    readonly workspaceId: string;
+};
+export type ListSessionsInput = Omit<SessionListParameters, "states"> & {
+    readonly states?: readonly string[];
+};
+export type StartSessionInput = {
+    readonly commandId?: string;
+    readonly expectedRevision: string;
+    readonly sessionId: string;
+};
+type SendAttachedSessionMessageInput = {
+    readonly body: string;
+    readonly commandId?: string;
+    readonly recipientSessionId: string;
+    readonly subject: string;
+};
+type AcknowledgeAttachedSessionDeliveryInput = {
+    readonly commandId?: string;
+    readonly deliveryId: string;
+    readonly expectedMailboxRevision: string;
+};
+export declare const makeSessionClient: (node: CliNodeOperations) => {
+    applyExecutionRelocation: (input: import("../execution/client.js").ApplyExecutionRelocationInput) => CliNodeEffect<import("@maiaos/sdk").ExecutionRelocationApplyResult>;
+    planExecutionRelocation: (input: import("../execution/client.js").PlanExecutionRelocationInput) => CliNodeEffect<import("@maiaos/sdk").ExecutionRelocationPlanResult>;
+    reconcileExecutionRelocation: (input: import("../execution/client.js").ReconcileExecutionRelocationInput) => CliNodeEffect<import("@maiaos/sdk").ExecutionRelocationReconcileResult>;
+    showExecutionRelocation: (relocationId: string) => CliNodeEffect<import("@maiaos/sdk").ExecutionRelocationShowResult>;
+    confirmAgentPermission: (input: import("@maiaos/sdk").AgentPermissionConfirmParameters) => CliNodeEffect<{
+        readonly delivery: "duplicate" | "new";
+        readonly grant: {
+            readonly definitionRef: {
+                readonly contentDigest: string;
+                readonly key: string;
+                readonly version: string;
+            };
+            readonly expectedSessionRevision: string;
+            readonly expectedWorkspaceRevision: string;
+            readonly sessionId: string;
+            readonly workspaceId: string;
+            readonly actorId: string;
+            readonly commandId: string;
+            readonly grantedAt: string;
+            readonly inputDigest: string;
+            readonly operationIds: readonly ("approval.list" | "approval.respond" | "approval.show" | "connection.capacity.set" | "connection.create" | "connection.detect" | "connection.gateway.create" | "connection.list" | "connection.login.start" | "connection.models.list" | "connection.show" | "connection.state.set" | "connection.system.confirm" | "connection.system.preview" | "connection.usage.show" | "container.create.confirm" | "container.create.preview" | "container.index.list" | "container.list" | "container.rename.confirm" | "container.rename.preview" | "container.show" | "context.show" | "discovery.sessions.list" | "execution.catalog.get" | "execution.checkpoint.create" | "execution.checkpoint.show" | "execution.command.run" | "execution.file.read" | "execution.placement.create" | "execution.placement.show" | "execution.relocation.apply" | "execution.relocation.plan" | "execution.relocation.reconcile" | "execution.relocation.show" | "execution.worktree.create" | "execution.worktree.import" | "execution.worktree.reconcile" | "execution.worktree.remove.apply" | "execution.worktree.remove.plan" | "execution.worktree.status" | "harness.installed.list" | "hold.list" | "hold.place.confirm" | "hold.place.preview" | "hold.release.confirm" | "hold.release.preview" | "integration.apply.claude-code" | "integration.apply.codex" | "integration.apply.pi-rpc" | "integration.plan.claude-code" | "integration.plan.codex" | "integration.plan.pi-rpc" | "integration.remove.claude-code" | "integration.remove.codex" | "integration.remove.pi-rpc" | "integration.status.claude-code" | "integration.status.codex" | "integration.status.pi-rpc" | "interaction.cancel" | "interaction.create" | "interaction.list" | "interaction.respond" | "interaction.show" | "monitor.bootstrap.create" | "node.remote.install.confirm" | "node.remote.install.preview" | "node.remote.list" | "node.remote.remove.confirm" | "node.remote.remove.preview" | "node.shutdown" | "node.status" | "port.lease.acquire" | "port.lease.list" | "port.lease.release" | "port.lease.renew" | "presentation.catalog.show" | "presentation.project-list.show" | "presentation.session-list.show" | "presentation.workspace-directory.show" | "project.context.list" | "project.context.record" | "project.context.show" | "project.create.confirm" | "project.create.preview" | "project.guard.confirm" | "project.guard.preview" | "project.guard.show" | "project.list" | "project.register" | "project.rename.confirm" | "project.rename.preview" | "project.show" | "provider.pool.list" | "receipt.get" | "receipt.list" | "reference.resolve" | "run.create" | "run.dispatch.settle-terminal" | "run.dispatch.show" | "run.inbox.ack" | "run.inbox.check" | "run.ledger.create" | "run.ledger.list" | "run.ledger.task.dispatch" | "run.ledger.task.list" | "run.ledger.task.settle" | "run.ledger.task.show" | "run.list" | "run.question.cancel" | "run.question.open" | "run.question.reply" | "run.show" | "run.task.list" | "run.task.show" | "runtime.probe" | "session.adopt.confirm" | "session.adopt.preview" | "session.agent-permission.confirm" | "session.agent-permission.preview" | "session.archive" | "session.create" | "session.diff" | "session.events.list" | "session.history.read" | "session.inbox.ack" | "session.inbox.check" | "session.list" | "session.message.send" | "session.observe" | "session.rename" | "session.resume" | "session.show" | "session.spawn" | "session.start" | "session.stop" | "terminal.controller.acquire" | "terminal.controller.release" | "terminal.controller.renew" | "terminal.controller.request" | "terminal.controller.request.show" | "terminal.create" | "terminal.events.list" | "terminal.input.write" | "terminal.list" | "terminal.mutation.reconcile" | "terminal.observer.attach" | "terminal.observer.check" | "terminal.observer.detach" | "terminal.observer.resync" | "terminal.read" | "terminal.session.close" | "terminal.session.delete" | "terminal.session.resize" | "terminal.session.restart" | "terminal.session.signal" | "terminal.show" | "turn.interrupt" | "turn.send" | "turn.show" | "turn.wait" | "voice.managed-turn.confirm" | "voice.managed-turn.preview" | "voice.orchestrator.context.show" | "voice.orchestrator.tool.call" | "voice.pi.relay" | "voice.pi.relay.preview" | "voice.pi.relay.reconcile" | "workspace.context.show" | "workspace.execution.configure" | "workspace.execution.show" | "workspace.list" | "workspace.membership.attach" | "workspace.repository.attach" | "workspace.select" | "workspace.show")[];
+            readonly revision: "1";
+        };
+        readonly method: "session.agent-permission.confirm";
+        readonly receipt: {
+            readonly actorId: string;
+            readonly aggregateRevision: string;
+            readonly commandId: string;
+            readonly createdAt: string;
+            readonly eventCursor: string;
+            readonly method: string;
+            readonly receiptId: string;
+            readonly schemaVersion: 1;
+            readonly state: "succeeded";
+            readonly target: {
+                readonly id: string;
+                readonly type: string;
+            };
+            readonly updatedAt: string;
+        };
+    }>;
+    previewAgentPermission: (input: import("@maiaos/sdk").AgentPermissionPreviewParameters) => CliNodeEffect<{
+        readonly definitionRef: {
+            readonly contentDigest: string;
+            readonly key: string;
+            readonly version: string;
+        };
+        readonly expectedSessionRevision: string;
+        readonly expectedWorkspaceRevision: string;
+        readonly sessionId: string;
+        readonly workspaceId: string;
+        readonly actorId: string;
+        readonly commandId: string;
+        readonly expiresAt: string;
+        readonly inputDigest: string;
+        readonly issuedAt: string;
+        readonly method: "session.agent-permission.preview";
+        readonly operationIds: readonly ("approval.list" | "approval.respond" | "approval.show" | "connection.capacity.set" | "connection.create" | "connection.detect" | "connection.gateway.create" | "connection.list" | "connection.login.start" | "connection.models.list" | "connection.show" | "connection.state.set" | "connection.system.confirm" | "connection.system.preview" | "connection.usage.show" | "container.create.confirm" | "container.create.preview" | "container.index.list" | "container.list" | "container.rename.confirm" | "container.rename.preview" | "container.show" | "context.show" | "discovery.sessions.list" | "execution.catalog.get" | "execution.checkpoint.create" | "execution.checkpoint.show" | "execution.command.run" | "execution.file.read" | "execution.placement.create" | "execution.placement.show" | "execution.relocation.apply" | "execution.relocation.plan" | "execution.relocation.reconcile" | "execution.relocation.show" | "execution.worktree.create" | "execution.worktree.import" | "execution.worktree.reconcile" | "execution.worktree.remove.apply" | "execution.worktree.remove.plan" | "execution.worktree.status" | "harness.installed.list" | "hold.list" | "hold.place.confirm" | "hold.place.preview" | "hold.release.confirm" | "hold.release.preview" | "integration.apply.claude-code" | "integration.apply.codex" | "integration.apply.pi-rpc" | "integration.plan.claude-code" | "integration.plan.codex" | "integration.plan.pi-rpc" | "integration.remove.claude-code" | "integration.remove.codex" | "integration.remove.pi-rpc" | "integration.status.claude-code" | "integration.status.codex" | "integration.status.pi-rpc" | "interaction.cancel" | "interaction.create" | "interaction.list" | "interaction.respond" | "interaction.show" | "monitor.bootstrap.create" | "node.remote.install.confirm" | "node.remote.install.preview" | "node.remote.list" | "node.remote.remove.confirm" | "node.remote.remove.preview" | "node.shutdown" | "node.status" | "port.lease.acquire" | "port.lease.list" | "port.lease.release" | "port.lease.renew" | "presentation.catalog.show" | "presentation.project-list.show" | "presentation.session-list.show" | "presentation.workspace-directory.show" | "project.context.list" | "project.context.record" | "project.context.show" | "project.create.confirm" | "project.create.preview" | "project.guard.confirm" | "project.guard.preview" | "project.guard.show" | "project.list" | "project.register" | "project.rename.confirm" | "project.rename.preview" | "project.show" | "provider.pool.list" | "receipt.get" | "receipt.list" | "reference.resolve" | "run.create" | "run.dispatch.settle-terminal" | "run.dispatch.show" | "run.inbox.ack" | "run.inbox.check" | "run.ledger.create" | "run.ledger.list" | "run.ledger.task.dispatch" | "run.ledger.task.list" | "run.ledger.task.settle" | "run.ledger.task.show" | "run.list" | "run.question.cancel" | "run.question.open" | "run.question.reply" | "run.show" | "run.task.list" | "run.task.show" | "runtime.probe" | "session.adopt.confirm" | "session.adopt.preview" | "session.agent-permission.confirm" | "session.agent-permission.preview" | "session.archive" | "session.create" | "session.diff" | "session.events.list" | "session.history.read" | "session.inbox.ack" | "session.inbox.check" | "session.list" | "session.message.send" | "session.observe" | "session.rename" | "session.resume" | "session.show" | "session.spawn" | "session.start" | "session.stop" | "terminal.controller.acquire" | "terminal.controller.release" | "terminal.controller.renew" | "terminal.controller.request" | "terminal.controller.request.show" | "terminal.create" | "terminal.events.list" | "terminal.input.write" | "terminal.list" | "terminal.mutation.reconcile" | "terminal.observer.attach" | "terminal.observer.check" | "terminal.observer.detach" | "terminal.observer.resync" | "terminal.read" | "terminal.session.close" | "terminal.session.delete" | "terminal.session.resize" | "terminal.session.restart" | "terminal.session.signal" | "terminal.show" | "turn.interrupt" | "turn.send" | "turn.show" | "turn.wait" | "voice.managed-turn.confirm" | "voice.managed-turn.preview" | "voice.orchestrator.context.show" | "voice.orchestrator.tool.call" | "voice.pi.relay" | "voice.pi.relay.preview" | "voice.pi.relay.reconcile" | "workspace.context.show" | "workspace.execution.configure" | "workspace.execution.show" | "workspace.list" | "workspace.membership.attach" | "workspace.repository.attach" | "workspace.select" | "workspace.show")[];
+        readonly proof: string;
+    }>;
+    attachSession: (input: import("./attach-client.js").AttachSessionInput) => CliNodeEffect<import("./attach-client.js").SessionAttachStream>;
+    archiveSession: (input: import("./coding-client.js").ArchiveSessionInput) => CliNodeEffect<import("@maiaos/sdk").SessionArchiveResult>;
+    diffSession: (input: import("./coding-client.js").DiffSessionInput) => CliNodeEffect<import("@maiaos/sdk").SessionDiffResult>;
+    acknowledgeAttachedSessionDelivery: (input: AcknowledgeAttachedSessionDeliveryInput) => CliNodeEffect<SessionInboxAckResult>;
+    awaitSessionRunning: (input: {
+        readonly deadlineMilliseconds: number;
+        readonly sessionId: string;
+    }) => CliNodeEffect<Session>;
+    checkAttachedSessionInbox: (input: {
+        readonly limit?: number;
+    }) => CliNodeEffect<SessionInboxCheckResult>;
+    createSession: (input: CreateSessionInput) => CliNodeEffect<SessionCreateResult>;
+    listSessionEvents: (input: {
+        readonly afterSessionCursor: string;
+        readonly limit: number;
+        readonly sessionId: string;
+    }) => CliNodeEffect<SessionEventsListResult>;
+    listSessions: (input: ListSessionsInput) => CliNodeEffect<SessionListResult>;
+    observeSessions: (input: {
+        readonly sessionIds?: readonly string[];
+        readonly stallAfterSeconds?: number;
+    }) => CliNodeEffect<SessionObserveResult>;
+    planSessions: (input: SessionCreationInput) => CliNodeEffect<SessionCreationPlan>;
+    resumeSession: (input: StartSessionInput) => CliNodeEffect<SessionResumeResult>;
+    runSessions: (plan: SessionCreationPlan) => CliNodeEffect<readonly SessionCreationOutcome[]>;
+    sendAttachedSessionMessage: (input: SendAttachedSessionMessageInput) => CliNodeEffect<SessionMessageSendResult>;
+    showSession: (sessionId: string) => CliNodeEffect<SessionShowResult>;
+    spawnSession: (input: SpawnSessionInput) => CliNodeEffect<SessionSpawnResult>;
+    startSession: (input: StartSessionInput) => CliNodeEffect<SessionStartResult>;
+    stopSession: (input: StartSessionInput) => CliNodeEffect<SessionStopResult>;
+};
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/session/client.js

@@ -0,0 +1,128 @@
+import { sessionCreateParametersSchema, sessionEventsListParametersSchema, sessionInboxAckParametersSchema, sessionInboxCheckParametersSchema, sessionListParametersSchema, sessionMessageSendParametersSchema, sessionObserveParametersSchema, sessionResumeParametersSchema, sessionShowParametersSchema, sessionSpawnParametersSchema, sessionStartParametersSchema, sessionStopParametersSchema, } from "@maiaos/sdk";
+import * as Crypto from "effect/Crypto";
+import * as Effect from "effect/Effect";
+import { makeRelocateClient } from "../execution/index.js";
+import { commandIdentifier, } from "../local-node/index.js";
+import { makeAgentPermissionCliClient } from "./agent-permission.js";
+import { makeAttachClient } from "./attach-client.js";
+import { makeCodingSessionClient } from "./coding-client.js";
+export const makeSessionClient = (node) => {
+    const createSession = (input) => {
+        return Effect.flatMap(commandIdentifier(input.commandId), (commandId) => {
+            return node.runValidatedNodeOperation({
+                commandId,
+                ...(input.connectionId === undefined
+                    ? {}
+                    : { connectionId: input.connectionId }),
+                expectedRevision: "0",
+                ...(input.definitionRef === undefined
+                    ? {}
+                    : { definitionRef: input.definitionRef }),
+                ...(input.executor === undefined ? {} : { executor: input.executor }),
+                ...(input.model === undefined ? {} : { model: input.model }),
+                ...(input.role === undefined ? {} : { role: input.role }),
+                ...(input.title === undefined ? {} : { title: input.title }),
+                workspaceId: input.workspaceId,
+                ...(input.baseRef === undefined
+                    ? {}
+                    : { worktree: { baseRef: input.baseRef } }),
+            }, sessionCreateParametersSchema, (client, parameters, options) => client.createSession(parameters, options), { commandId });
+        });
+    };
+    const listSessions = (input) => {
+        return node.runValidatedNodeOperation(input, sessionListParametersSchema, (client, parameters, options) => client.listSessions(parameters, options));
+    };
+    const showSession = (sessionId) => {
+        return node.runValidatedNodeOperation({ sessionId }, sessionShowParametersSchema, (client, parameters, options) => client.showSession(parameters, options));
+    };
+    const observeSessions = (input) => node.runValidatedNodeOperation(input, sessionObserveParametersSchema, (client, parameters, options) => client.observeSessions(parameters, options));
+    const listSessionEvents = (input) => {
+        return node.runValidatedNodeOperation(input, sessionEventsListParametersSchema, (client, parameters, options) => client.listSessionEvents(parameters, options));
+    };
+    const sendAttachedSessionMessage = (input) => {
+        return Effect.flatMap(commandIdentifier(input.commandId), (commandId) => {
+            const parameters = sessionMessageSendParametersSchema.parse({
+                ...input,
+                commandId,
+            });
+            return node.runDiscoveryOperation((options) => Effect.promise(() => import("@maiaos/sdk/node/effect")).pipe(Effect.flatMap((sdk) => sdk.sendAttachedSessionMessageEffect(parameters, options))));
+        });
+    };
+    const checkAttachedSessionInbox = (input) => {
+        const parameters = sessionInboxCheckParametersSchema.parse(input);
+        return node.runDiscoveryOperation((options) => Effect.promise(() => import("@maiaos/sdk/node/effect")).pipe(Effect.flatMap((sdk) => sdk.checkAttachedSessionInboxEffect(parameters, options))));
+    };
+    const acknowledgeAttachedSessionDelivery = (input) => {
+        return Effect.flatMap(commandIdentifier(input.commandId), (commandId) => {
+            const parameters = sessionInboxAckParametersSchema.parse({
+                ...input,
+                commandId,
+            });
+            return node.runDiscoveryOperation((options) => Effect.promise(() => import("@maiaos/sdk/node/effect")).pipe(Effect.flatMap((sdk) => sdk.acknowledgeAttachedSessionDeliveryEffect(parameters, options))));
+        });
+    };
+    const spawnSession = (input) => {
+        return Effect.flatMap(commandIdentifier(input.commandId), (commandId) => {
+            return node.runValidatedNodeOperation({
+                commandId,
+                expectedRevision: "0",
+                harness: input.harness,
+                parentSessionId: input.parentSessionId,
+                workspaceId: input.workspaceId,
+            }, sessionSpawnParametersSchema, (client, parameters, options) => client.spawnSession(parameters, options), { commandId });
+        });
+    };
+    const startSession = (input) => {
+        return Effect.flatMap(commandIdentifier(input.commandId), (commandId) => {
+            return node.runValidatedNodeOperation({
+                commandId,
+                expectedRevision: input.expectedRevision,
+                sessionId: input.sessionId,
+            }, sessionStartParametersSchema, (client, parameters, options) => client.startSession(parameters, options), { commandId });
+        });
+    };
+    const stopSession = (input) => {
+        return Effect.flatMap(commandIdentifier(input.commandId), (commandId) => {
+            return node.runValidatedNodeOperation({
+                commandId,
+                expectedRevision: input.expectedRevision,
+                sessionId: input.sessionId,
+            }, sessionStopParametersSchema, (client, parameters, options) => client.stopSession(parameters, options), { commandId });
+        });
+    };
+    const resumeSession = (input) => {
+        return Effect.flatMap(commandIdentifier(input.commandId), (commandId) => {
+            return node.runValidatedNodeOperation({
+                commandId,
+                expectedRevision: input.expectedRevision,
+                sessionId: input.sessionId,
+            }, sessionResumeParametersSchema, (client, parameters, options) => client.resumeSession(parameters, options), { commandId });
+        });
+    };
+    const withSdk = (operation) => Effect.flatMap(Crypto.Crypto, (crypto) => node.runNodeClientOperation((client) => Effect.promise(() => import("@maiaos/sdk/node/effect")).pipe(Effect.flatMap((sdk) => operation(sdk, client)), Effect.provideService(Crypto.Crypto, crypto))));
+    const planSessions = (input) => withSdk((sdk, client) => sdk.planSessionCreationEffect(client, input));
+    const runSessions = (plan) => withSdk((sdk, client) => sdk.createSessionsEffect(client, plan));
+    const awaitSessionRunning = (input) => withSdk((sdk, client) => sdk.awaitSessionRunningEffect(client, input.sessionId, input.deadlineMilliseconds));
+    return {
+        acknowledgeAttachedSessionDelivery,
+        awaitSessionRunning,
+        checkAttachedSessionInbox,
+        createSession,
+        listSessionEvents,
+        listSessions,
+        observeSessions,
+        planSessions,
+        resumeSession,
+        runSessions,
+        sendAttachedSessionMessage,
+        showSession,
+        spawnSession,
+        startSession,
+        stopSession,
+        ...makeRelocateClient(node),
+        ...makeAgentPermissionCliClient(node),
+        ...makeCodingSessionClient(node),
+        ...makeAttachClient(node),
+    };
+};
+//# sourceMappingURL=client.js.map

package/dist/session/coding-client.d.ts

@@ -0,0 +1,16 @@
+import type { SessionArchiveResult, SessionDiffResult } from "@maiaos/sdk";
+import { type CliNodeEffect, type CliNodeOperations } from "../local-node/index.js";
+export type DiffSessionInput = {
+    readonly sessionId: string;
+    readonly stat: boolean;
+};
+export type ArchiveSessionInput = {
+    readonly commandId?: string;
+    readonly expectedRevision: string;
+    readonly sessionId: string;
+};
+export declare const makeCodingSessionClient: (node: CliNodeOperations) => {
+    archiveSession: (input: ArchiveSessionInput) => CliNodeEffect<SessionArchiveResult>;
+    diffSession: (input: DiffSessionInput) => CliNodeEffect<SessionDiffResult>;
+};
+//# sourceMappingURL=coding-client.d.ts.map

package/dist/session/coding-client.js

@@ -0,0 +1,15 @@
+import { sessionArchiveParametersSchema, sessionDiffParametersSchema, } from "@maiaos/sdk";
+import * as Effect from "effect/Effect";
+import { commandIdentifier, } from "../local-node/index.js";
+export const makeCodingSessionClient = (node) => ({
+    archiveSession: (input) => Effect.flatMap(commandIdentifier(input.commandId), (commandId) => node.runValidatedNodeOperation({
+        commandId,
+        expectedRevision: input.expectedRevision,
+        sessionId: input.sessionId,
+    }, sessionArchiveParametersSchema, (client, parameters, options) => client.archiveSession(parameters, options), { commandId })),
+    diffSession: (input) => node.runValidatedNodeOperation({
+        sessionId: input.sessionId,
+        ...(input.stat ? { stat: true } : {}),
+    }, sessionDiffParametersSchema, (client, parameters, options) => client.diffSession(parameters, options)),
+});
+//# sourceMappingURL=coding-client.js.map

package/dist/session/coding-commands.d.ts

@@ -0,0 +1,4 @@
+import { type CommandContext, type CommandEffect } from "../command-line/index.js";
+export declare const runSessionDiff: (tokens: readonly string[], context: CommandContext) => CommandEffect;
+export declare const runSessionArchive: (tokens: readonly string[], context: CommandContext) => CommandEffect;
+//# sourceMappingURL=coding-commands.d.ts.map

package/dist/session/coding-commands.js

@@ -0,0 +1,50 @@
+import { Effect } from "effect";
+import { CliArgumentError, parseOptions, readExpectedRevision, requirePositionals, } from "../command-line/index.js";
+import { writeSessionResult } from "./output/index.js";
+const requireSessionId = (positionals) => {
+    const sessionId = positionals[0];
+    if (sessionId === undefined)
+        throw new CliArgumentError("The session identifier is missing.");
+    return sessionId;
+};
+export const runSessionDiff = (tokens, context) => Effect.gen(function* () {
+    const parsed = parseOptions(tokens, new Set(), new Set(["--stat"]));
+    requirePositionals(parsed.positionals, 1);
+    const { diffSession } = context.dependencies;
+    if (diffSession === undefined)
+        throw new CliArgumentError("Session diff is unavailable.");
+    const result = yield* diffSession({
+        sessionId: requireSessionId(parsed.positionals),
+        stat: parsed.flags.has("--stat"),
+    });
+    return writeSessionResult(result, context, (value) => ({
+        command: "session.diff",
+        result: value,
+    }));
+});
+const summarizeArchive = (result) => ({
+    ...(result.archive === undefined ? {} : { archive: result.archive }),
+    delivery: result.delivery,
+    receipt: result.receipt,
+    revision: result.session.revision,
+    sessionId: result.session.id,
+    state: result.session.state,
+});
+export const runSessionArchive = (tokens, context) => Effect.gen(function* () {
+    const parsed = parseOptions(tokens, new Set(["--command-id", "--expected-revision"]));
+    requirePositionals(parsed.positionals, 1);
+    const { archiveSession } = context.dependencies;
+    if (archiveSession === undefined)
+        throw new CliArgumentError("Session archive is unavailable.");
+    const commandId = parsed.options.get("--command-id");
+    const result = yield* archiveSession({
+        ...(commandId === undefined ? {} : { commandId }),
+        expectedRevision: readExpectedRevision(parsed.options.get("--expected-revision")),
+        sessionId: requireSessionId(parsed.positionals),
+    });
+    return writeSessionResult(result, context, (value) => ({
+        command: "session.archive",
+        result: summarizeArchive(value),
+    }));
+});
+//# sourceMappingURL=coding-commands.js.map

package/dist/session/commands.d.ts

@@ -0,0 +1,13 @@
+import { type CommandContext, type CommandEffect } from "../command-line/index.js";
+export declare const runSessionCreate: (tokens: readonly string[], context: CommandContext) => CommandEffect;
+export declare const runSessionList: (tokens: readonly string[], context: CommandContext) => CommandEffect;
+export declare const runSessionShow: (tokens: readonly string[], context: CommandContext) => CommandEffect;
+export declare const runSessionStart: (tokens: readonly string[], context: CommandContext) => CommandEffect;
+export declare const runSessionStop: (tokens: readonly string[], context: CommandContext) => CommandEffect;
+export declare const runSessionResume: (tokens: readonly string[], context: CommandContext) => CommandEffect;
+export declare const runSessionEventsList: (tokens: readonly string[], context: CommandContext) => CommandEffect;
+export declare const runSessionObserve: (tokens: readonly string[], context: CommandContext) => CommandEffect;
+export declare const runSessionMessageSend: (tokens: readonly string[], context: CommandContext) => CommandEffect;
+export declare const runSessionInboxCheck: (tokens: readonly string[], context: CommandContext) => CommandEffect;
+export declare const runSessionInboxAck: (tokens: readonly string[], context: CommandContext) => CommandEffect;
+//# sourceMappingURL=commands.d.ts.map