Service limits

These are externally meaningful limits enforced by current schemas and runtime code. Use them for validation and capacity planning; do not treat them as billing entitlements or recommended batch sizes.

Last verified: commit 8d1ac043 on 2026-07-20.

Contract

Fixed product limits apply to every Tenant. Runtime bounds marked configurable have deployment defaults within an enforced operator range. A Tenant Quota is self-set token/request protection, while billing measurement is a separate policy described by Usage and quotas.

Byte values use binary units (1 MiB = 1,048,576 bytes). String .max() values are character/string-unit limits unless a byte refinement proves otherwise. In particular, the current Prompt template schema enforces 10,240 JavaScript string units despite the constant's historical ...BYTES name.

Limit behavior is not uniform. Memory capacity evicts rather than rejects; Task overlap skips without a Task-run row; Sandbox contention queues rather than returning SANDBOX_BUSY; context-window overflow is a Provider failure because the full Session history is sent without platform truncation. A Turn deadline does not roll back an external operation already accepted by a Tool.

Internal deployment values such as SANDBOX_CAPACITY, DBOS polling and pool sizes, scheduler repair intervals, service ports, and cleanup batch sizes are not public service limits. Draft plan entitlements and TBD billing rates in docs/billing.md are also excluded until they are enforced and settled.

Session Turns, stateless generation, and Task execution are metered Turns. Memory rows are explicitly excluded from the Durable storage meter. A Tenant's self-set Quota is not a billing plan or a rate limit.

Examples

An oversized Skill archive can return HTTP 413 with this valid envelope:

{
  "error": {
    "code": "invalid_request",
    "message": "Skill zip must be at most 3145728 bytes"
  }
}

Monitor totals against an optional Tenant ceiling without calculating a bill:

const [usage, settings] = await Promise.all([
  client.usage.get({ from: "2026-07-01", to: "2026-07-20" }),
  client.tenant.get(),
]);

const ceiling = settings.quota?.monthlyRequestLimit;
if (ceiling !== null && ceiling !== undefined) {
  const remaining = ceiling - usage.totals.requestCount;
  if (remaining < ceiling * 0.1) console.warn("Request Quota is nearly used");
}

Used by

• Errors
• Pagination and filtering
• SDK Usage
• SDK Tenant settings
• REST Usage
• REST Tenant settings
• Limits and reliability
• Usage and quotas
• Monitor usage and quotas
• Troubleshoot a failed integration

Resource-specific rows also apply to their matching SDK, REST, and Capability pages.

Source of truth

• packages/core/src/limitations.ts
• packages/core/src/limitations.test.ts
• packages/core/src/entities/agents.ts
• packages/core/src/entities/apikeys.ts
• packages/core/src/entities/mcp-connections.ts
• packages/core/src/entities/memories.ts
• packages/core/src/entities/prompts.ts
• packages/core/src/entities/providers.ts
• packages/core/src/entities/sandboxes.ts
• packages/core/src/entities/sessions.ts
• packages/core/src/entities/skills.ts
• packages/core/src/entities/tasks.ts
• packages/core/src/entities/tenants.ts
• packages/core/src/entities/usage.ts
• packages/core/src/entities/agents.test.ts
• packages/core/src/entities/agent-tools.ts
• packages/core/src/entities/agent-tools.test.ts
• packages/core/src/entities/apikeys.test.ts
• packages/core/src/entities/mcp-connections.test.ts
• packages/core/src/entities/memories.test.ts
• packages/core/src/entities/prompts.test.ts
• packages/core/src/entities/providers.test.ts
• packages/core/src/entities/sandboxes.test.ts
• packages/core/src/entities/sessions.test.ts
• packages/core/src/entities/skills.test.ts
• packages/core/src/entities/tasks-inputs.test.ts
• packages/core/src/entities/tasks-schedules.test.ts
• packages/core/src/entities/tenants.test.ts
• packages/core/src/entities/usage.test.ts
• servers/api/src/services/agent-service.ts
• servers/api/src/services/agent-service-create.test.ts
• servers/api/src/services/agent-service-versions.test.ts
• servers/api/src/services/api-key-service.ts
• servers/api/src/services/api-key-service.test.ts
• servers/api/src/services/mcp-connection-service.ts
• servers/api/src/services/mcp-connection-service.test.ts
• servers/api/src/services/prompt-service.ts
• servers/api/src/services/prompt-service.test.ts
• servers/api/src/services/provider-service.ts
• servers/api/src/services/provider-service-create.test.ts
• servers/api/src/services/provider-service-update.test.ts
• packages/server-core/src/skill-service.ts
• packages/server-core/src/skill-service-create.test.ts
• packages/server-core/src/artifact-service.ts
• packages/server-core/src/artifact-service-record.test.ts
• packages/server-core/src/memory-service.ts
• packages/server-core/src/memory-service-create.test.ts
• packages/server-core/src/memory-service-list.test.ts
• packages/server-core/src/task.ts
• packages/server-core/src/task-service-create.test.ts
• packages/server-core/src/task-service-queries.test.ts
• packages/server-core/src/agent-tools/save-artifacts.ts
• packages/server-core/src/agent-tools/save-artifacts.test.ts
• packages/server-core/src/agent-tools/shared.ts
• packages/server-core/src/agent-tools/write.ts
• packages/server-core/src/agent-tools/edit.ts
• packages/server-core/src/agent-tools/grep.ts
• packages/server-core/src/agent-tools/glob.ts
• packages/server-core/src/agent-tools/tools-files.test.ts
• packages/server-core/src/agent-tools/tools-search.test.ts
• packages/server-core/src/agent-loop/run-agent.ts
• packages/server-core/src/agent-loop/run-agent-errors.test.ts
• packages/server-core/src/agent-loop/run-stateless.ts
• packages/server-core/src/agent-loop/run-stateless.test.ts
• packages/server-core/src/mcp/mcp-runtime-config.ts
• packages/server-core/src/mcp/mcp-tool-runtime.ts
• packages/server-core/src/mcp/mcp-tool-runtime.test.ts
• packages/server-core/src/mcp/validate-mcp-connection.ts
• packages/server-core/src/mcp/mcp-client-lifecycle.ts
• servers/api/src/env.ts
• servers/api/src/env.test.ts
• servers/task-worker/src/env.ts
• servers/task-worker/src/env.test.ts
• servers/task-worker/src/task-run-execution.ts
• supabase/migrations/20260719000000_tables_memories.sql
• docs/billing.md for settled billing distinctions only

Related guides

See the capability and guide links under Used by.

Reference

See the implementation inventory under Source of truth.