Skip to main content

AgentSession

Owner/app-scoped durable agent conversation with pinned mode, model, policy, registry, and client epoch.

type AgentSession {
  contractVersion: String!
  sessionId: String!
  appId: BigInt!
  projectId: String
  gridId: BigInt
  mode: CrowdyStudioAgentMode!
  requestedModel: String!
  model: String
  resolvedModel: String
  status: CrowdyStudioAgentSessionStatus!
  providerDataConsent: Boolean!
  registryDigest: String!
  providerPolicyVersion: String!
  appPolicyVersion: String!
  contextVersion: String!
  currentClientEpoch: BigInt!
  clientEpoch: BigInt
  lastEventSeq: BigInt!
  activeRun: AgentRun
  currentRun: AgentRun
  activeLeases: [AgentLease!]!
  pendingApproval: AgentApproval
  createdAt: DateTime!
  updatedAt: DateTime!
  closedAt: DateTime
}

Fields​

AgentSession.contractVersion ● String! non-null scalar​

Session contract version; always 'crowdy.studio-agent/1'.

AgentSession.sessionId ● String! non-null scalar​

Stable session UUID.

AgentSession.appId ● BigInt! non-null scalar​

App tenant from the app-scoped bearer token.

AgentSession.projectId ● String scalar​

Selected private project UUID, or null. Returned only to its exact owner/app.

AgentSession.gridId ● BigInt scalar​

Selected grid id, or null; it does not grant authority.

AgentSession.mode ● CrowdyStudioAgentMode! non-null enum​

Human-selected current mode.

AgentSession.requestedModel ● String! non-null scalar​

Requested model in the effective platform/app allowlist.

AgentSession.model ● String scalar​

Selected allowlisted model, matching the SDK session model.

AgentSession.resolvedModel ● String scalar​

Resolved routed model after a provider response, or null.

AgentSession.status ● CrowdyStudioAgentSessionStatus! non-null enum​

Current durable session lifecycle.

Whether the human accepted first-use disclosure of selected private project source. Messages and metadata do not imply this consent.

AgentSession.registryDigest ● String! non-null scalar​

Digest of the mode/policy-filtered immutable tool registry.

AgentSession.providerPolicyVersion ● String! non-null scalar​

Opaque platform provider-policy version pinned at creation.

AgentSession.appPolicyVersion ● String! non-null scalar​

Opaque management app-policy version pinned at creation.

AgentSession.contextVersion ● String! non-null scalar​

Current authoritative context version.

AgentSession.currentClientEpoch ● BigInt! non-null scalar​

Monotonic attached client epoch. A newer attach fences all older tabs.

AgentSession.clientEpoch ● BigInt scalar​

SDK-compatible attached client epoch, or null before attach.

AgentSession.lastEventSeq ● BigInt! non-null scalar​

Highest committed durable event sequence.

AgentSession.activeRun ● AgentRun object​

Current non-terminal run, or null.

AgentSession.currentRun ● AgentRun object​

SDK-compatible current non-terminal run, or null.

AgentSession.activeLeases ● [AgentLease!]! non-null object​

Current unexpired leases; bounded to WORKSPACE and PLAY.

AgentSession.pendingApproval ● AgentApproval object​

Newest unexpired pending approval, or null.

AgentSession.createdAt ● DateTime! non-null scalar​

Session creation timestamp.

AgentSession.updatedAt ● DateTime! non-null scalar​

Latest durable session update.

AgentSession.closedAt ● DateTime scalar​

Close timestamp, or null while open.

Returned By​

crowdyStudioAgentCloseSession mutation ● crowdyStudioAgentCreateSession mutation ● crowdyStudioAgentPause mutation ● crowdyStudioAgentResume mutation ● crowdyStudioAgentSession query ● crowdyStudioAgentSetMode mutation

Member Of​

AgentClientAttachment object ● AgentSessionConnection object ● AgentSessionEdge object