@maiaos/protocol 0.1.0-canary.1

package/dist/session/feature.js

@@ -0,0 +1,362 @@
+import { defineMaiaFeature, } from "../feature/descriptor/index.js";
+/** Vendor executor Sessions and their turns, as the Desktop daily driver drives them. */
+export const SESSION_FEATURE_OPERATIONS = [
+    {
+        method: "session.create",
+        nodeHandler: "session",
+        policy: {
+            confirmation: "none",
+            effectClass: "native-idempotent",
+            idempotency: "command-id",
+            ownReceipt: true,
+            receipt: "required",
+            releaseQualified: false,
+            revisionGuard: false,
+            risk: "reversible",
+        },
+        primitives: ["receipt"],
+        projections: {
+            cli: true,
+            coordinator: {
+                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.',
+                destructive: false,
+                readOnly: false,
+            },
+            desktop: "reviewed-renderer-local-node",
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "createSession" },
+    },
+    {
+        method: "session.start",
+        nodeHandler: "session",
+        policy: {
+            confirmation: "none",
+            effectClass: "native-reconcilable",
+            idempotency: "command-id",
+            ownReceipt: true,
+            receipt: "required",
+            releaseQualified: false,
+            revisionGuard: true,
+            risk: "reversible",
+        },
+        primitives: ["receipt"],
+        projections: {
+            cli: true,
+            coordinator: {
+                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.",
+                destructive: false,
+                readOnly: false,
+            },
+            desktop: "reviewed-renderer-local-node",
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "startSession" },
+    },
+    {
+        method: "session.stop",
+        nodeHandler: "session",
+        policy: {
+            confirmation: "none",
+            effectClass: "native-reconcilable",
+            idempotency: "command-id",
+            ownReceipt: true,
+            receipt: "required",
+            releaseQualified: false,
+            revisionGuard: true,
+            risk: "reversible",
+        },
+        primitives: ["receipt"],
+        projections: {
+            cli: true,
+            coordinator: {
+                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.",
+                destructive: true,
+                readOnly: false,
+            },
+            desktop: "reviewed-renderer-local-node",
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "stopSession" },
+    },
+    {
+        method: "session.resume",
+        nodeHandler: "session",
+        policy: {
+            confirmation: "none",
+            effectClass: "native-reconcilable",
+            idempotency: "command-id",
+            ownReceipt: true,
+            receipt: "required",
+            releaseQualified: false,
+            revisionGuard: true,
+            risk: "reversible",
+        },
+        primitives: ["receipt"],
+        projections: {
+            cli: true,
+            coordinator: {
+                description: "Resume a stopped or failed Session at its current revision, on its recorded vendor thread when it has one.",
+                destructive: false,
+                readOnly: false,
+            },
+            desktop: "reviewed-renderer-local-node",
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "resumeSession" },
+    },
+    {
+        method: "session.archive",
+        nodeHandler: "session",
+        policy: {
+            confirmation: "none",
+            effectClass: "native-reconcilable",
+            idempotency: "command-id",
+            ownReceipt: true,
+            receipt: "required",
+            releaseQualified: false,
+            revisionGuard: true,
+            risk: "reversible",
+        },
+        primitives: ["receipt"],
+        projections: {
+            cli: true,
+            coordinator: {
+                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.",
+                destructive: true,
+                readOnly: false,
+            },
+            desktop: "reviewed-renderer-local-node",
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "archiveSession" },
+    },
+    {
+        method: "session.rename",
+        nodeHandler: "session",
+        policy: {
+            confirmation: "none",
+            effectClass: "native-idempotent",
+            idempotency: "command-id",
+            ownReceipt: true,
+            receipt: "required",
+            releaseQualified: false,
+            revisionGuard: true,
+            risk: "reversible",
+        },
+        primitives: ["receipt"],
+        projections: {
+            cli: true,
+            coordinator: {
+                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.",
+                destructive: false,
+                readOnly: false,
+            },
+            desktop: false,
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "call" },
+    },
+    {
+        method: "session.diff",
+        nodeHandler: "session",
+        policy: {
+            confirmation: "none",
+            effectClass: "none",
+            idempotency: "none",
+            ownReceipt: false,
+            receipt: "none",
+            releaseQualified: false,
+            revisionGuard: false,
+            risk: "read",
+        },
+        primitives: ["read"],
+        projections: {
+            cli: true,
+            coordinator: {
+                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).",
+                destructive: false,
+                readOnly: true,
+            },
+            desktop: "reviewed-renderer-local-node",
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "diffSession" },
+    },
+    {
+        method: "session.observe",
+        nodeHandler: "session",
+        policy: {
+            confirmation: "none",
+            effectClass: "none",
+            idempotency: "none",
+            ownReceipt: false,
+            receipt: "none",
+            releaseQualified: false,
+            revisionGuard: false,
+            risk: "read",
+        },
+        primitives: ["read"],
+        projections: {
+            cli: true,
+            coordinator: {
+                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).",
+                destructive: false,
+                readOnly: true,
+            },
+            desktop: "reviewed-renderer-local-node",
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "observeSessions" },
+    },
+    {
+        method: "session.events.list",
+        nodeHandler: "session",
+        policy: {
+            confirmation: "none",
+            effectClass: "none",
+            idempotency: "none",
+            ownReceipt: false,
+            receipt: "none",
+            releaseQualified: false,
+            revisionGuard: false,
+            risk: "read",
+        },
+        primitives: ["read"],
+        projections: {
+            cli: true,
+            coordinator: {
+                description: 'Durable Session history, up to 32 events per page. First page: afterSessionCursor "0"; next page: nextSessionCursor.',
+                destructive: false,
+                readOnly: true,
+            },
+            desktop: "reviewed-renderer-local-node",
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "listSessionEvents" },
+    },
+    {
+        method: "turn.send",
+        nodeHandler: "turn",
+        policy: {
+            confirmation: "trusted-client-required",
+            effectClass: "external-uncertain",
+            idempotency: "command-id",
+            ownReceipt: true,
+            receipt: "required",
+            releaseQualified: false,
+            revisionGuard: true,
+            risk: "consequential",
+        },
+        primitives: ["confirmation", "message", "receipt"],
+        projections: {
+            cli: true,
+            coordinator: {
+                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.",
+                destructive: false,
+                readOnly: false,
+            },
+            desktop: "reviewed-renderer-local-node",
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "sendTurn" },
+    },
+    {
+        method: "turn.wait",
+        nodeHandler: "turn",
+        policy: {
+            confirmation: "none",
+            effectClass: "none",
+            idempotency: "none",
+            ownReceipt: false,
+            receipt: "none",
+            releaseQualified: false,
+            revisionGuard: false,
+            risk: "read",
+        },
+        primitives: ["read"],
+        projections: {
+            cli: true,
+            coordinator: {
+                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.",
+                destructive: false,
+                readOnly: true,
+            },
+            desktop: "reviewed-renderer-local-node",
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "waitTurns" },
+    },
+    {
+        method: "turn.show",
+        nodeHandler: "turn",
+        policy: {
+            confirmation: "none",
+            effectClass: "none",
+            idempotency: "none",
+            ownReceipt: false,
+            receipt: "none",
+            releaseQualified: false,
+            revisionGuard: false,
+            risk: "read",
+        },
+        primitives: ["read"],
+        projections: {
+            cli: true,
+            coordinator: {
+                description: "Show one turn: state, revision, failure reason and, once completed, the response text.",
+                destructive: false,
+                readOnly: true,
+            },
+            desktop: "reviewed-renderer-local-node",
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "showTurn" },
+    },
+    {
+        method: "turn.interrupt",
+        nodeHandler: "turn",
+        policy: {
+            confirmation: "none",
+            effectClass: "native-reconcilable",
+            idempotency: "command-id",
+            ownReceipt: true,
+            receipt: "required",
+            releaseQualified: false,
+            revisionGuard: true,
+            risk: "reversible",
+        },
+        primitives: ["receipt"],
+        projections: {
+            cli: true,
+            coordinator: {
+                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.",
+                destructive: true,
+                readOnly: false,
+            },
+            desktop: "reviewed-renderer-local-node",
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "interruptTurn" },
+    },
+];
+export const SESSION_FEATURE = defineMaiaFeature({
+    contributions: { routines: [], rules: [], schedules: [], skills: [] },
+    id: "session",
+    operations: SESSION_FEATURE_OPERATIONS,
+    schemaVersion: "maia.feature/session/v1",
+});
+//# sourceMappingURL=feature.js.map

package/dist/session/feature.js.map

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

package/dist/session/index.d.ts

@@ -0,0 +1,8 @@
+export { type AgentPermissionConfirmParameters, agentPermissionConfirmParametersSchema, type AgentPermissionConfirmResult, agentPermissionConfirmResultSchema, type AgentPermissionGrant, agentPermissionGrantSchema, type AgentPermissionPreviewParameters, agentPermissionPreviewParametersSchema, type AgentPermissionPreviewResult, agentPermissionPreviewResultSchema, } from "./agent-permission-contract.js";
+export { type FailureDetail, type Session, type SessionArchiveParameters, sessionArchiveParametersSchema, type SessionArchiveResult, sessionArchiveResultSchema, type SessionBaseRef, sessionBaseRefSchema, type SessionCreateParameters, sessionCreateParametersSchema, type SessionCreateResult, sessionCreateResultSchema, type SessionDelivery, sessionDeliverySchema, type SessionDiffParameters, sessionDiffParametersSchema, type SessionDiffResult, sessionDiffResultSchema, type SessionEvent, sessionEventSchema, type SessionEventsListParameters, sessionEventsListParametersSchema, type SessionEventsListResult, sessionEventsListResultSchema, type SessionInboxAckParameters, sessionInboxAckParametersSchema, type SessionInboxAckResult, sessionInboxAckResultSchema, type SessionInboxCheckParameters, sessionInboxCheckParametersSchema, type SessionInboxCheckResult, sessionInboxCheckResultSchema, type SessionListParameters, sessionListParametersSchema, type SessionListResult, sessionListResultSchema, type SessionMailbox, sessionMailboxSchema, type SessionMessage, sessionMessageSchema, type SessionMessageSendParameters, sessionMessageSendParametersSchema, type SessionMessageSendResult, sessionMessageSendResultSchema, type SessionRenameParameters, sessionRenameParametersSchema, type SessionRenameResult, sessionRenameResultSchema, type SessionResult, sessionSchema, type SessionShowParameters, sessionShowParametersSchema, type SessionShowResult, sessionShowResultSchema, type SessionSpawnParameters, sessionSpawnParametersSchema, type SessionSpawnResult, sessionSpawnResultSchema, type SessionStartParameters, sessionStartParametersSchema, type SessionStartResult, sessionStartResultSchema, type SessionWorktree, sessionWorktreeSchema, } from "./contract.js";
+export { SESSION_FEATURE } from "./feature.js";
+export { type SessionAttention, type SessionObservation, sessionObservationSchema, type SessionObserveParameters, sessionObserveParametersSchema, type SessionObserveResult, sessionObserveResultSchema, } from "./observation-contract.js";
+export { DEFAULT_SESSION_INBOX_CHECK_LIMIT, DEFAULT_SESSION_LIST_PAGE_SIZE, DEFAULT_SESSION_STALL_AFTER_SECONDS, MAX_SESSION_BASE_REF_BYTES, MAX_SESSION_DIFF_FILES, MAX_SESSION_DIFF_PATCH_BYTES, MAX_SESSION_INBOX_CHECK_LIMIT, MAX_SESSION_INBOX_CHECK_RESULT_BYTES, MAX_SESSION_MAILBOX_CONTENT_BYTES, MAX_SESSION_MAILBOX_DELIVERIES, MAX_SESSION_MESSAGE_BODY_BYTES, MAX_SESSION_MESSAGE_SUBJECT_BYTES, MAX_SESSION_OBSERVE_IDS, MAX_SESSION_STALL_AFTER_SECONDS, MAX_SESSION_TITLE_LENGTH, MIN_SESSION_STALL_AFTER_SECONDS, SESSION_ATTENTION_VALUES, } from "./policy.js";
+export { type SessionResumeParameters, sessionResumeParametersSchema, type SessionResumeResult, sessionResumeResultSchema, type SessionStopParameters, sessionStopParametersSchema, type SessionStopResult, sessionStopResultSchema, } from "./stop-resume-contract.js";
+export { LEGACY_SESSION_SCHEMA_VERSION, SESSION_EVENT_SCHEMA_VERSION, SESSION_SCHEMA_VERSION, } from "./version.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gCAAgC,EACrC,sCAAsC,EACtC,KAAK,4BAA4B,EACjC,kCAAkC,EAClC,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,KAAK,gCAAgC,EACrC,sCAAsC,EACtC,KAAK,4BAA4B,EACjC,kCAAkC,GACnC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,KAAK,wBAAwB,EAC7B,8BAA8B,EAC9B,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,KAAK,cAAc,EACnB,oBAAoB,EACpB,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,KAAK,eAAe,EACpB,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,iBAAiB,EACtB,uBAAuB,EACvB,KAAK,YAAY,EACjB,kBAAkB,EAClB,KAAK,2BAA2B,EAChC,iCAAiC,EACjC,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,KAAK,yBAAyB,EAC9B,+BAA+B,EAC/B,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,2BAA2B,EAChC,iCAAiC,EACjC,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,iBAAiB,EACtB,uBAAuB,EACvB,KAAK,cAAc,EACnB,oBAAoB,EACpB,KAAK,cAAc,EACnB,oBAAoB,EACpB,KAAK,4BAA4B,EACjC,kCAAkC,EAClC,KAAK,wBAAwB,EAC7B,8BAA8B,EAC9B,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,KAAK,aAAa,EAClB,aAAa,EACb,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,iBAAiB,EACtB,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,wBAAwB,EACxB,KAAK,eAAe,EACpB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,8BAA8B,EAC9B,KAAK,oBAAoB,EACzB,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,iCAAiC,EACjC,8BAA8B,EAC9B,mCAAmC,EACnC,0BAA0B,EAC1B,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,EAC7B,oCAAoC,EACpC,iCAAiC,EACjC,8BAA8B,EAC9B,8BAA8B,EAC9B,iCAAiC,EACjC,uBAAuB,EACvB,+BAA+B,EAC/B,wBAAwB,EACxB,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,iBAAiB,EACtB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,cAAc,CAAC"}

package/dist/session/index.js

@@ -0,0 +1,8 @@
+export { agentPermissionConfirmParametersSchema, agentPermissionConfirmResultSchema, agentPermissionGrantSchema, agentPermissionPreviewParametersSchema, agentPermissionPreviewResultSchema, } from "./agent-permission-contract.js";
+export { sessionArchiveParametersSchema, sessionArchiveResultSchema, sessionBaseRefSchema, sessionCreateParametersSchema, sessionCreateResultSchema, sessionDeliverySchema, sessionDiffParametersSchema, sessionDiffResultSchema, sessionEventSchema, sessionEventsListParametersSchema, sessionEventsListResultSchema, sessionInboxAckParametersSchema, sessionInboxAckResultSchema, sessionInboxCheckParametersSchema, sessionInboxCheckResultSchema, sessionListParametersSchema, sessionListResultSchema, sessionMailboxSchema, sessionMessageSchema, sessionMessageSendParametersSchema, sessionMessageSendResultSchema, sessionRenameParametersSchema, sessionRenameResultSchema, sessionSchema, sessionShowParametersSchema, sessionShowResultSchema, sessionSpawnParametersSchema, sessionSpawnResultSchema, sessionStartParametersSchema, sessionStartResultSchema, sessionWorktreeSchema, } from "./contract.js";
+export { SESSION_FEATURE } from "./feature.js";
+export { sessionObservationSchema, sessionObserveParametersSchema, sessionObserveResultSchema, } from "./observation-contract.js";
+export { DEFAULT_SESSION_INBOX_CHECK_LIMIT, DEFAULT_SESSION_LIST_PAGE_SIZE, DEFAULT_SESSION_STALL_AFTER_SECONDS, MAX_SESSION_BASE_REF_BYTES, MAX_SESSION_DIFF_FILES, MAX_SESSION_DIFF_PATCH_BYTES, MAX_SESSION_INBOX_CHECK_LIMIT, MAX_SESSION_INBOX_CHECK_RESULT_BYTES, MAX_SESSION_MAILBOX_CONTENT_BYTES, MAX_SESSION_MAILBOX_DELIVERIES, MAX_SESSION_MESSAGE_BODY_BYTES, MAX_SESSION_MESSAGE_SUBJECT_BYTES, MAX_SESSION_OBSERVE_IDS, MAX_SESSION_STALL_AFTER_SECONDS, MAX_SESSION_TITLE_LENGTH, MIN_SESSION_STALL_AFTER_SECONDS, SESSION_ATTENTION_VALUES, } from "./policy.js";
+export { sessionResumeParametersSchema, sessionResumeResultSchema, sessionStopParametersSchema, sessionStopResultSchema, } from "./stop-resume-contract.js";
+export { LEGACY_SESSION_SCHEMA_VERSION, SESSION_EVENT_SCHEMA_VERSION, SESSION_SCHEMA_VERSION, } from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sCAAsC,EAEtC,kCAAkC,EAElC,0BAA0B,EAE1B,sCAAsC,EAEtC,kCAAkC,GACnC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAIL,8BAA8B,EAE9B,0BAA0B,EAE1B,oBAAoB,EAEpB,6BAA6B,EAE7B,yBAAyB,EAEzB,qBAAqB,EAErB,2BAA2B,EAE3B,uBAAuB,EAEvB,kBAAkB,EAElB,iCAAiC,EAEjC,6BAA6B,EAE7B,+BAA+B,EAE/B,2BAA2B,EAE3B,iCAAiC,EAEjC,6BAA6B,EAE7B,2BAA2B,EAE3B,uBAAuB,EAEvB,oBAAoB,EAEpB,oBAAoB,EAEpB,kCAAkC,EAElC,8BAA8B,EAE9B,6BAA6B,EAE7B,yBAAyB,EAEzB,aAAa,EAEb,2BAA2B,EAE3B,uBAAuB,EAEvB,4BAA4B,EAE5B,wBAAwB,EAExB,4BAA4B,EAE5B,wBAAwB,EAExB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAGL,wBAAwB,EAExB,8BAA8B,EAE9B,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,iCAAiC,EACjC,8BAA8B,EAC9B,mCAAmC,EACnC,0BAA0B,EAC1B,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,EAC7B,oCAAoC,EACpC,iCAAiC,EACjC,8BAA8B,EAC9B,8BAA8B,EAC9B,iCAAiC,EACjC,uBAAuB,EACvB,+BAA+B,EAC/B,wBAAwB,EACxB,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,6BAA6B,EAE7B,yBAAyB,EAEzB,2BAA2B,EAE3B,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,cAAc,CAAC"}

package/dist/session/observation-contract.d.ts

@@ -0,0 +1,73 @@
+import type { InferRuntimeSchema } from "../runtime-schema/index.js";
+export declare const sessionObserveParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly sessionIds?: readonly string[] | undefined;
+    readonly stallAfterSeconds?: number | undefined;
+}>;
+export type SessionObserveParameters = InferRuntimeSchema<typeof sessionObserveParametersSchema>;
+export declare const sessionObservationSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly attention?: "approval_pending" | "failed" | "question" | "settled_unreviewed" | "stalled" | "turn_failed" | undefined;
+    readonly runtime?: {
+        readonly activity: {
+            readonly declinedRequests: number;
+            readonly eventCount: number;
+            readonly idleMilliseconds: number;
+            readonly lastEventAt?: string | undefined;
+            readonly lastEventKind?: string | undefined;
+        };
+        readonly health: "idle" | "stalled" | "working";
+        readonly process?: {
+            readonly cpuTimeMilliseconds?: number | undefined;
+            readonly processCount?: number | undefined;
+            readonly rssBytes?: number | undefined;
+            readonly wallTimeMilliseconds?: number | undefined;
+        } | undefined;
+        readonly runtime: "claude-code" | "codex-cli" | "pi";
+        readonly runtimeThreadId: string;
+        readonly startedAt: string;
+        readonly turn?: {
+            readonly elapsedMilliseconds: number;
+            readonly runtimeTurnId: string;
+            readonly startedAt: string;
+            readonly turnId: string;
+        } | undefined;
+    } | undefined;
+    readonly sessionId: string;
+}>;
+export type SessionObservation = InferRuntimeSchema<typeof sessionObservationSchema>;
+export declare const sessionObserveResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly items: readonly {
+        readonly attention?: "approval_pending" | "failed" | "question" | "settled_unreviewed" | "stalled" | "turn_failed" | undefined;
+        readonly runtime?: {
+            readonly activity: {
+                readonly declinedRequests: number;
+                readonly eventCount: number;
+                readonly idleMilliseconds: number;
+                readonly lastEventAt?: string | undefined;
+                readonly lastEventKind?: string | undefined;
+            };
+            readonly health: "idle" | "stalled" | "working";
+            readonly process?: {
+                readonly cpuTimeMilliseconds?: number | undefined;
+                readonly processCount?: number | undefined;
+                readonly rssBytes?: number | undefined;
+                readonly wallTimeMilliseconds?: number | undefined;
+            } | undefined;
+            readonly runtime: "claude-code" | "codex-cli" | "pi";
+            readonly runtimeThreadId: string;
+            readonly startedAt: string;
+            readonly turn?: {
+                readonly elapsedMilliseconds: number;
+                readonly runtimeTurnId: string;
+                readonly startedAt: string;
+                readonly turnId: string;
+            } | undefined;
+        } | undefined;
+        readonly sessionId: string;
+    }[];
+    readonly method: "session.observe";
+    readonly observedAt: string;
+    readonly stallAfterSeconds: number;
+}>;
+export type SessionObserveResult = InferRuntimeSchema<typeof sessionObserveResultSchema>;
+export type SessionAttention = NonNullable<SessionObservation["attention"]>;
+//# sourceMappingURL=observation-contract.d.ts.map

package/dist/session/observation-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-contract.d.ts","sourceRoot":"","sources":["../../src/session/observation-contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAQrE,eAAO,MAAM,8BAA8B;;;EAE1C,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CACvD,OAAO,8BAA8B,CACtC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEpC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,CACjD,OAAO,wBAAwB,CAChC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEtC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CACnD,OAAO,0BAA0B,CAClC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC"}

package/dist/session/observation-contract.js

@@ -0,0 +1,6 @@
+import { makeEffectRuntimeSchema } from "../runtime-schema/effect-schema.js";
+import { sessionObservationEffectSchema, sessionObserveParametersEffectSchema, sessionObserveResultEffectSchema, } from "./observation-effect-schema.js";
+export const sessionObserveParametersSchema = makeEffectRuntimeSchema(sessionObserveParametersEffectSchema);
+export const sessionObservationSchema = makeEffectRuntimeSchema(sessionObservationEffectSchema);
+export const sessionObserveResultSchema = makeEffectRuntimeSchema(sessionObserveResultEffectSchema);
+//# sourceMappingURL=observation-contract.js.map

package/dist/session/observation-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-contract.js","sourceRoot":"","sources":["../../src/session/observation-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAG7E,OAAO,EACL,8BAA8B,EAC9B,oCAAoC,EACpC,gCAAgC,GACjC,MAAM,gCAAgC,CAAC;AAExC,MAAM,CAAC,MAAM,8BAA8B,GAAG,uBAAuB,CACnE,oCAAoC,CACrC,CAAC;AAMF,MAAM,CAAC,MAAM,wBAAwB,GAAG,uBAAuB,CAC7D,8BAA8B,CAC/B,CAAC;AAMF,MAAM,CAAC,MAAM,0BAA0B,GAAG,uBAAuB,CAC/D,gCAAgC,CACjC,CAAC"}

package/dist/session/observation-effect-schema.d.ts

@@ -0,0 +1,73 @@
+import * as Schema from "effect/Schema";
+export declare const sessionObserveParametersEffectSchema: Schema.Struct<{
+    readonly sessionIds: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly stallAfterSeconds: Schema.optional<Schema.Int>;
+}>;
+/**
+ * A requested Session without a live runtime carries no runtime field;
+ * `attention` is absent when the Session needs nothing.
+ */
+export declare const sessionObservationEffectSchema: Schema.Struct<{
+    readonly attention: Schema.optional<Schema.Literals<readonly ["failed", "approval_pending", "question", "turn_failed", "stalled", "settled_unreviewed"]>>;
+    readonly runtime: Schema.optional<Schema.Struct<{
+        readonly activity: Schema.Struct<{
+            readonly declinedRequests: Schema.Int;
+            readonly eventCount: Schema.Int;
+            readonly idleMilliseconds: Schema.Int;
+            readonly lastEventAt: Schema.optional<Schema.String>;
+            readonly lastEventKind: Schema.optional<Schema.String>;
+        }>;
+        readonly health: Schema.Literals<readonly ["idle", "stalled", "working"]>;
+        readonly process: Schema.optional<Schema.Struct<{
+            readonly cpuTimeMilliseconds: Schema.optional<Schema.Int>;
+            readonly processCount: Schema.optional<Schema.Int>;
+            readonly rssBytes: Schema.optional<Schema.Int>;
+            readonly wallTimeMilliseconds: Schema.optional<Schema.Int>;
+        }>>;
+        readonly runtime: Schema.Literals<readonly ["claude-code", "codex-cli", "pi"]>;
+        readonly runtimeThreadId: Schema.String;
+        readonly startedAt: Schema.String;
+        readonly turn: Schema.optional<Schema.Struct<{
+            readonly elapsedMilliseconds: Schema.Int;
+            readonly runtimeTurnId: Schema.String;
+            readonly startedAt: Schema.String;
+            readonly turnId: Schema.String;
+        }>>;
+    }>>;
+    readonly sessionId: Schema.String;
+}>;
+export declare const sessionObserveResultEffectSchema: Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly attention: Schema.optional<Schema.Literals<readonly ["failed", "approval_pending", "question", "turn_failed", "stalled", "settled_unreviewed"]>>;
+        readonly runtime: Schema.optional<Schema.Struct<{
+            readonly activity: Schema.Struct<{
+                readonly declinedRequests: Schema.Int;
+                readonly eventCount: Schema.Int;
+                readonly idleMilliseconds: Schema.Int;
+                readonly lastEventAt: Schema.optional<Schema.String>;
+                readonly lastEventKind: Schema.optional<Schema.String>;
+            }>;
+            readonly health: Schema.Literals<readonly ["idle", "stalled", "working"]>;
+            readonly process: Schema.optional<Schema.Struct<{
+                readonly cpuTimeMilliseconds: Schema.optional<Schema.Int>;
+                readonly processCount: Schema.optional<Schema.Int>;
+                readonly rssBytes: Schema.optional<Schema.Int>;
+                readonly wallTimeMilliseconds: Schema.optional<Schema.Int>;
+            }>>;
+            readonly runtime: Schema.Literals<readonly ["claude-code", "codex-cli", "pi"]>;
+            readonly runtimeThreadId: Schema.String;
+            readonly startedAt: Schema.String;
+            readonly turn: Schema.optional<Schema.Struct<{
+                readonly elapsedMilliseconds: Schema.Int;
+                readonly runtimeTurnId: Schema.String;
+                readonly startedAt: Schema.String;
+                readonly turnId: Schema.String;
+            }>>;
+        }>>;
+        readonly sessionId: Schema.String;
+    }>>;
+    readonly method: Schema.Literal<"session.observe">;
+    readonly observedAt: Schema.String;
+    readonly stallAfterSeconds: Schema.Int;
+}>;
+//# sourceMappingURL=observation-effect-schema.d.ts.map

package/dist/session/observation-effect-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-effect-schema.d.ts","sourceRoot":"","sources":["../../src/session/observation-effect-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAkBxC,eAAO,MAAM,oCAAoC;;;EAa/C,CAAC;AAsCH;;;GAGG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIzC,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU3C,CAAC"}

package/dist/session/observation-effect-schema.js

@@ -0,0 +1,55 @@
+import * as Schema from "effect/Schema";
+import { protocolIdentifierEffectSchema, recordedAtEffectSchema, } from "../envelope/effect-schema.js";
+import { MAX_SESSION_OBSERVE_IDS, MAX_SESSION_OBSERVE_ITEMS, MAX_SESSION_STALL_AFTER_SECONDS, MIN_SESSION_STALL_AFTER_SECONDS, SESSION_ATTENTION_VALUES, } from "./policy.js";
+const countEffectSchema = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0));
+const measuredEffectSchema = Schema.optional(countEffectSchema);
+export const sessionObserveParametersEffectSchema = Schema.Struct({
+    sessionIds: Schema.optional(Schema.Array(protocolIdentifierEffectSchema).check(Schema.isMinLength(1), Schema.isMaxLength(MAX_SESSION_OBSERVE_IDS))),
+    stallAfterSeconds: Schema.optional(Schema.Int.check(Schema.isGreaterThanOrEqualTo(MIN_SESSION_STALL_AFTER_SECONDS), Schema.isLessThanOrEqualTo(MAX_SESSION_STALL_AFTER_SECONDS))),
+});
+/** Runtime record kinds; observation never carries prompt or model text. */
+const sessionActivityEffectSchema = Schema.Struct({
+    declinedRequests: countEffectSchema,
+    eventCount: countEffectSchema,
+    idleMilliseconds: countEffectSchema,
+    lastEventAt: Schema.optional(recordedAtEffectSchema),
+    lastEventKind: Schema.optional(Schema.String.check(Schema.isBetweenLength(1, 128))),
+});
+/** A value the platform cannot measure is absent, never zero. */
+const sessionProcessObservationEffectSchema = Schema.Struct({
+    cpuTimeMilliseconds: measuredEffectSchema,
+    processCount: measuredEffectSchema,
+    rssBytes: measuredEffectSchema,
+    wallTimeMilliseconds: measuredEffectSchema,
+});
+const sessionTurnObservationEffectSchema = Schema.Struct({
+    elapsedMilliseconds: countEffectSchema,
+    runtimeTurnId: Schema.String.check(Schema.isBetweenLength(1, 256)),
+    startedAt: recordedAtEffectSchema,
+    turnId: protocolIdentifierEffectSchema,
+});
+const sessionRuntimeObservationEffectSchema = Schema.Struct({
+    activity: sessionActivityEffectSchema,
+    health: Schema.Literals(["idle", "stalled", "working"]),
+    process: Schema.optional(sessionProcessObservationEffectSchema),
+    runtime: Schema.Literals(["claude-code", "codex-cli", "pi"]),
+    runtimeThreadId: Schema.String.check(Schema.isBetweenLength(1, 256)),
+    startedAt: recordedAtEffectSchema,
+    turn: Schema.optional(sessionTurnObservationEffectSchema),
+});
+/**
+ * A requested Session without a live runtime carries no runtime field;
+ * `attention` is absent when the Session needs nothing.
+ */
+export const sessionObservationEffectSchema = Schema.Struct({
+    attention: Schema.optional(Schema.Literals(SESSION_ATTENTION_VALUES)),
+    runtime: Schema.optional(sessionRuntimeObservationEffectSchema),
+    sessionId: protocolIdentifierEffectSchema,
+});
+export const sessionObserveResultEffectSchema = Schema.Struct({
+    items: Schema.Array(sessionObservationEffectSchema).check(Schema.isMaxLength(MAX_SESSION_OBSERVE_ITEMS)),
+    method: Schema.Literal("session.observe"),
+    observedAt: recordedAtEffectSchema,
+    stallAfterSeconds: Schema.Int.check(Schema.isGreaterThanOrEqualTo(MIN_SESSION_STALL_AFTER_SECONDS), Schema.isLessThanOrEqualTo(MAX_SESSION_STALL_AFTER_SECONDS)),
+});
+//# sourceMappingURL=observation-effect-schema.js.map

package/dist/session/observation-effect-schema.js.map

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