@maiaos/protocol 0.1.0-canary.1

package/dist/session/feature.d.ts

@@ -0,0 +1,382 @@
+import { type MaiaOperationsFeature } from "../feature/descriptor/index.js";
+/** Vendor executor Sessions and their turns, as the Desktop daily driver drives them. */
+export declare const SESSION_FEATURE_OPERATIONS: readonly [{
+    readonly method: "session.create";
+    readonly nodeHandler: "session";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "native-idempotent";
+        readonly idempotency: "command-id";
+        readonly ownReceipt: true;
+        readonly receipt: "required";
+        readonly releaseQualified: false;
+        readonly revisionGuard: false;
+        readonly risk: "reversible";
+    };
+    readonly primitives: readonly ["receipt"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: 'Create a Session in a Workspace. Set executor ("codex-cli" or "claude-code") to let the Node pick the account with the most usage left, or connectionId to bind one account; a gateway connectionId also needs executor and may take a model; expectedRevision is "0". Without worktree the worker only reads the Workspace; with worktree.baseRef (a branch, tag or commit) it codes in its own new worktree on branch maia/<workspace-id>. Choose a unique commandId and reuse it to retry. Give it a title, or it takes the first line of its first turn. The result\'s session.id is the sessionId the other Session tools take.';
+            readonly destructive: false;
+            readonly readOnly: false;
+        };
+        readonly desktop: "reviewed-renderer-local-node";
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "createSession";
+    };
+}, {
+    readonly method: "session.start";
+    readonly nodeHandler: "session";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "native-reconcilable";
+        readonly idempotency: "command-id";
+        readonly ownReceipt: true;
+        readonly receipt: "required";
+        readonly releaseQualified: false;
+        readonly revisionGuard: true;
+        readonly risk: "reversible";
+    };
+    readonly primitives: readonly ["receipt"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "Admit a created Session for launch at its current revision. The receipt confirms admission only; poll session_show until the state is running, which also returns the revision turn_send needs. Fails as saturated when the Node, the account slots or its limit window are full.";
+            readonly destructive: false;
+            readonly readOnly: false;
+        };
+        readonly desktop: "reviewed-renderer-local-node";
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "startSession";
+    };
+}, {
+    readonly method: "session.stop";
+    readonly nodeHandler: "session";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "native-reconcilable";
+        readonly idempotency: "command-id";
+        readonly ownReceipt: true;
+        readonly receipt: "required";
+        readonly releaseQualified: false;
+        readonly revisionGuard: true;
+        readonly risk: "reversible";
+    };
+    readonly primitives: readonly ["receipt"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "Stop a Session at its current revision: queued turns fail, a running turn settles outcome-unknown, and the Session keeps its vendor thread for resume.";
+            readonly destructive: true;
+            readonly readOnly: false;
+        };
+        readonly desktop: "reviewed-renderer-local-node";
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "stopSession";
+    };
+}, {
+    readonly method: "session.resume";
+    readonly nodeHandler: "session";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "native-reconcilable";
+        readonly idempotency: "command-id";
+        readonly ownReceipt: true;
+        readonly receipt: "required";
+        readonly releaseQualified: false;
+        readonly revisionGuard: true;
+        readonly risk: "reversible";
+    };
+    readonly primitives: readonly ["receipt"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "Resume a stopped or failed Session at its current revision, on its recorded vendor thread when it has one.";
+            readonly destructive: false;
+            readonly readOnly: false;
+        };
+        readonly desktop: "reviewed-renderer-local-node";
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "resumeSession";
+    };
+}, {
+    readonly method: "session.archive";
+    readonly nodeHandler: "session";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "native-reconcilable";
+        readonly idempotency: "command-id";
+        readonly ownReceipt: true;
+        readonly receipt: "required";
+        readonly releaseQualified: false;
+        readonly revisionGuard: true;
+        readonly risk: "reversible";
+    };
+    readonly primitives: readonly ["receipt"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "Archive a coding Session at its current revision: stop it, commit any uncommitted work to its branch (kept) and remove its worktree after a delay. Merging, rebasing and pull requests stay with a person.";
+            readonly destructive: true;
+            readonly readOnly: false;
+        };
+        readonly desktop: "reviewed-renderer-local-node";
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "archiveSession";
+    };
+}, {
+    readonly method: "session.rename";
+    readonly nodeHandler: "session";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "native-idempotent";
+        readonly idempotency: "command-id";
+        readonly ownReceipt: true;
+        readonly receipt: "required";
+        readonly releaseQualified: false;
+        readonly revisionGuard: true;
+        readonly risk: "reversible";
+    };
+    readonly primitives: readonly ["receipt"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "Rename a Session at its current revision: a one-line title of at most 80 characters. Titles need not be unique. A Session without one takes the first line of its first turn.";
+            readonly destructive: false;
+            readonly readOnly: false;
+        };
+        readonly desktop: false;
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "call";
+    };
+}, {
+    readonly method: "session.diff";
+    readonly nodeHandler: "session";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "none";
+        readonly idempotency: "none";
+        readonly ownReceipt: false;
+        readonly receipt: "none";
+        readonly releaseQualified: false;
+        readonly revisionGuard: false;
+        readonly risk: "read";
+    };
+    readonly primitives: readonly ["read"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "Show what a coding Session changed against its base revision: each file with its line counts and, unless stat is true, the patch (truncated past 48 KiB).";
+            readonly destructive: false;
+            readonly readOnly: true;
+        };
+        readonly desktop: "reviewed-renderer-local-node";
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "diffSession";
+    };
+}, {
+    readonly method: "session.observe";
+    readonly nodeHandler: "session";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "none";
+        readonly idempotency: "none";
+        readonly ownReceipt: false;
+        readonly receipt: "none";
+        readonly releaseQualified: false;
+        readonly revisionGuard: false;
+        readonly risk: "read";
+    };
+    readonly primitives: readonly ["read"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "Live runtime view of running Sessions (or the listed ones): running turn and elapsed time, activity, idle time, process usage and health (idle, working, stalled).";
+            readonly destructive: false;
+            readonly readOnly: true;
+        };
+        readonly desktop: "reviewed-renderer-local-node";
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "observeSessions";
+    };
+}, {
+    readonly method: "session.events.list";
+    readonly nodeHandler: "session";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "none";
+        readonly idempotency: "none";
+        readonly ownReceipt: false;
+        readonly receipt: "none";
+        readonly releaseQualified: false;
+        readonly revisionGuard: false;
+        readonly risk: "read";
+    };
+    readonly primitives: readonly ["read"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: 'Durable Session history, up to 32 events per page. First page: afterSessionCursor "0"; next page: nextSessionCursor.';
+            readonly destructive: false;
+            readonly readOnly: true;
+        };
+        readonly desktop: "reviewed-renderer-local-node";
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "listSessionEvents";
+    };
+}, {
+    readonly method: "turn.send";
+    readonly nodeHandler: "turn";
+    readonly policy: {
+        readonly confirmation: "trusted-client-required";
+        readonly effectClass: "external-uncertain";
+        readonly idempotency: "command-id";
+        readonly ownReceipt: true;
+        readonly receipt: "required";
+        readonly releaseQualified: false;
+        readonly revisionGuard: true;
+        readonly risk: "consequential";
+    };
+    readonly primitives: readonly ["confirmation", "message", "receipt"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "Send one text prompt to a running Session at its current revision (session_show, or the sessionRevision of its newest turn); the turn queues behind any running turn. A stale revision fails with a message naming the current one.";
+            readonly destructive: false;
+            readonly readOnly: false;
+        };
+        readonly desktop: "reviewed-renderer-local-node";
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "sendTurn";
+    };
+}, {
+    readonly method: "turn.wait";
+    readonly nodeHandler: "turn";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "none";
+        readonly idempotency: "none";
+        readonly ownReceipt: false;
+        readonly receipt: "none";
+        readonly releaseQualified: false;
+        readonly revisionGuard: false;
+        readonly risk: "read";
+    };
+    readonly primitives: readonly ["read"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "Hold up to waitMilliseconds (at most 4000, so one call stays inside the 5-second request deadline) until all (mode all) or any (mode any) listed turns settle; call again to keep waiting.";
+            readonly destructive: false;
+            readonly readOnly: true;
+        };
+        readonly desktop: "reviewed-renderer-local-node";
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "waitTurns";
+    };
+}, {
+    readonly method: "turn.show";
+    readonly nodeHandler: "turn";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "none";
+        readonly idempotency: "none";
+        readonly ownReceipt: false;
+        readonly receipt: "none";
+        readonly releaseQualified: false;
+        readonly revisionGuard: false;
+        readonly risk: "read";
+    };
+    readonly primitives: readonly ["read"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "Show one turn: state, revision, failure reason and, once completed, the response text.";
+            readonly destructive: false;
+            readonly readOnly: true;
+        };
+        readonly desktop: "reviewed-renderer-local-node";
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "showTurn";
+    };
+}, {
+    readonly method: "turn.interrupt";
+    readonly nodeHandler: "turn";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "native-reconcilable";
+        readonly idempotency: "command-id";
+        readonly ownReceipt: true;
+        readonly receipt: "required";
+        readonly releaseQualified: false;
+        readonly revisionGuard: true;
+        readonly risk: "reversible";
+    };
+    readonly primitives: readonly ["receipt"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "Interrupt a running turn at its Session's current revision (session_show, or turn_show's sessionRevision when it is the Session's newest turn). A stale revision fails with a message naming the current one.";
+            readonly destructive: true;
+            readonly readOnly: false;
+        };
+        readonly desktop: "reviewed-renderer-local-node";
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "interruptTurn";
+    };
+}];
+export declare const SESSION_FEATURE: MaiaOperationsFeature<"session", typeof SESSION_FEATURE_OPERATIONS>;
+//# sourceMappingURL=feature.d.ts.map

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

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