DocsArchitectureChangelogBlogView source

Changelog

Notable product updates, client releases, and security improvements. Package-specific patch notes remain in each client repository.

Security

The private API now requires Cloudflare Access

  • Private API runtime df151a2

Every request to api.delega.dev must now pass Cloudflare Access before it reaches Delega, so a leaked agent key alone no longer works from the internet.

  • Two credentials for agents: Agents present a per-host Cloudflare Access service token and their existing Delega agent key. The maintained MCP, CLI and Python clients already send both when the DELEGA_CF_ACCESS_CLIENT_ID and DELEGA_CF_ACCESS_CLIENT_SECRET pair is configured.
  • Owner sign-in for the dashboard: The browser dashboard, task console and docs try-it send the owner's Cloudflare Access email sign-in with each request; the API answers credentialed CORS only for its listed origins and still requires X-Agent-Key.
  • Narrow public routes: Only health, security.txt, signed ingress, one-use answer links, the answer-broker pull and the GitHub setup, callback and webhook routes skip Access. Each keeps its own signature or token check.

Availability: Enforced on the existing private API runtime. Public hosted signup remains retired.

Known limitations

  • A browser needs one Cloudflare email sign-in per 24-hour session before the dashboard can reach the API.
  • Clients without the service-token pair are refused at the edge.

References: Credentialed CORSProduction deploymentDashboard sign-in

Developer

Durable private human checklist requests

  • Private API contract 30b6c91

An opt-in private API contract lets agents register a checklist on an existing task, retrieve protected human replies and canonical results, or cancel without taking the executor's claim.

  • One immutable request: Equal registration retries reuse the same request. Scope, executor, claim generation and an absolute deadline stay bound to the original task; registration does not send or approve execution.
  • Protected result evidence: Human replies and their protected records commit together. A result requires both affirmative replies and canonical completion by the original executor; agent-written context cannot substitute for that proof.
  • Cancellation and expiry: The API rechecks cancellation, deadline and ownership inside prompt-capability, answer and completion writes. The controller retains responsibility for releasing its own claim.

Availability: Deployed to the existing private API runtime with registration still disabled. Controller and client adapters are merged as source; package publication and installed runtime activation remain separate. Public hosted signup remains retired.

Known limitations

  • Only the existing self recipient and a reviewed two-prompt checklist run are supported, for at most 20 minutes.
  • A completed checklist is human-attested; physical readiness is not independently verified.
  • An already in-flight Telegram send cannot be recalled. The controller checks cancellation and America/Chicago quiet hours before delivery.
  • Package publication, installed runtime updates and live execution are separate activation steps.

References: Human request APIProduction deploymentController adapterMCP toolsCLI commandsPython SDK

Security

Human replies stay bound to their original task decision

  • Private API runtime 8255ca8

Broker-issued answer links now reject stale replies after the task or its claim changes, so an old human answer cannot be attached to newer work.

  • Exact decision checks: Reply links bind the task revision and claim generation. Saving an answer also requires the original active claim, waiting question and unexpired lease.
  • Safe concurrent changes: A reply that loses a race with a task change is rejected without creating a fallback human-authored comment.
  • Signed client contract: The broker returns signed snapshot metadata so opt-in controllers can require the protected reply contract before sending a prompt.

Availability: Available in the existing private API runtime. Public hosted signup remains retired; the checklist pilot is separately enabled.

Known limitations

  • Existing broker-issued links must be reissued after this update. Email-issued answer links retain their previous behavior.
  • A task heartbeat or context update changes its revision and invalidates an outstanding broker link; request a fresh prompt.
  • A checklist reply is a human attestation, not independent verification of physical readiness.

References: Broker reply protectionReply contract and migrationProduction deployment

Developer

Complete task discovery with smaller context reads

  • Private API runtime d1483bb
  • MCP 1.19.0 06a1bbb

The private API and MCP client add explicit task pagination and targeted context retrieval, so agents can recover current work without loading the entire backlog or accumulated history.

  • Complete discovery: Task summaries include actor-scoped totals and continuation offsets. The MCP advances only past rows actually shown, even when its character budget shortens a page.
  • Targeted state: Read canonical current-state keys, browse a paginated key index, or select exact historical keys. Context versions and selected provenance remain available for guarded writes.
  • Bounded output: MCP task details, context and history default to 6,000-character responses. Large reads have explicit content-bound continuation cursors; writes and conflicts no longer echo merged history.

Availability: Deployed to production and shared staging; MCP 1.19.0 is published to npm and the MCP Registry. Public hosted signup remains retired.

Upgrade after the API deployment

npm install -g @delega-dev/[email protected]

Known limitations

  • Offset task pagination is not an immutable snapshot across concurrent writes.
  • Large JSON reads return explicitly labeled fragments; changed content invalidates continuation cursors.
  • Deploy the API support before updating MCP clients. Older array-only APIs cannot provide the new complete-pagination contract.

References: API read representationsMCP bounded readsMCP 1.19.0 release

Security

Private API query parsing hardened

  • Private API runtime d6b0fc0

The private API runtime now uses Hono 4.13.5, incorporating upstream request parsing security fixes.

  • Query boundaries respected: The framework stops query parsing at URL fragments, preventing parameters inside fragments from being interpreted as ordinary query parameters.
  • Framework maintenance: The update also includes upstream static site generation path containment and deeply nested form parsing fixes. Delega does not enable those affected features.

Availability: Deployed to the existing private API runtime. No client upgrade is required.

References: API framework updateHono 4.13.5 security fixes

Developer

Client filters, errors, and staging requests corrected

  • MCP 1.18.5 e72b410
  • CLI 1.9.10 / 1.9.9 / 1.9.8 5a302a6
  • Python SDK 0.6.5 e41aaae

Maintenance releases improve task filtering, HTTP error handling, and staging support in the clients maintained for the private Delega runtime.

  • Python filter and error consistency: Python SDK 0.6.5 sends lowercase boolean filters from both transports and preserves SDK error types for nested and non-object JSON error responses.
  • Hosted staging support: MCP 1.18.5 uses the hosted API namespace for the canonical staging host, including task claims, while preserving custom endpoint behavior.
  • CLI maintenance and status accuracy: CLI 1.9.10 removes unused error-handling code. It includes the earlier 1.9.8 fleet pagination and 1.9.9 task-status corrections, which were previously missing from this release ledger.

Availability: Published packages remain available for the existing private runtime. Public hosted signup remains retired.

Install the maintenance releases

npm install -g @delega-dev/[email protected]
npm install -g @delega-dev/[email protected]
pip install -U delega==0.6.5

Known limitation

  • Cloudflare Access credentials are required as a complete pair for Access-protected hosts. They supplement the existing Delega agent key.

References: delega-cli 1.9.10delega-mcp 1.18.5delega-python 0.6.5

Security

Private clients add Cloudflare Access authentication

  • MCP 1.18.4 268ac38
  • CLI 1.9.7 df7065e
  • Python SDK 0.6.4 78a342d

The maintained MCP, CLI, and Python clients can now present a Cloudflare Access service token before the existing Delega agent credential, enabling defense-in-depth for Ryan McMillan’s private hosted runtime.

  • Edge and application credentials: MCP 1.18.4, CLI 1.9.7, and Python SDK 0.6.4 add the paired DELEGA_CF_ACCESS_CLIENT_ID and DELEGA_CF_ACCESS_CLIENT_SECRET headers while preserving the existing per-agent Delega key at the application layer.
  • Consistent client coverage: The CLI applies the edge credential to normal commands, login, initialization, and status checks; both synchronous and asynchronous Python clients accept constructor arguments or environment variables; and MCP applies the pair to every API request.
  • Incomplete pairs fail closed: A client ID without its matching secret, or a secret without its matching client ID, is rejected instead of silently falling back to an unprotected request.
  • MCP dependency advisories resolved: The MCP release also advances the fast-uri and qs transitive pins to versions that resolve the current npm runtime advisories, with npm audit: 0 vulnerabilities.

Availability: Client support is published for the existing owner runtime. Production Access enforcement remains staged until every approved host is migrated and validated.

Upgrade Access-aware clients

npm install -g @delega-dev/[email protected]
npm install -g @delega-dev/[email protected]
pip install -U delega==0.6.4

Known limitations

  • Cloudflare Access service tokens supplement rather than replace Delega agent keys; authenticated API operations require both layers after edge enforcement is enabled.
  • The new variables are optional for custom endpoints that do not use Cloudflare Access, but they must be configured as a complete pair when used.

References: MCP 1.18.4 releaseCLI 1.9.7 releasePython SDK 0.6.4 release

Developer

Task concurrency and supersession contracts

  • Private API runtime 9dc3128

The owner-runtime task API now exposes monotonic task revisions and claim generations, machine-readable conflict codes, idempotent retries, and audit-preserving task replacement for safer multi-agent coordination.

  • Optimistic task writes: Every task now carries a monotonic revision. Direct API clients can pass expected_revision to updates, targeted claims, and completion so one concurrent writer wins and stale decisions fail with the current revision.
  • Lease-holder fencing: Each successful claim or reclaim advances claim_generation. Heartbeat, state, release, and completion requests can bind that generation so an old process cannot mutate a later lease held by the same agent identity.
  • Auditable replacements: Creating a task with supersedes_task_id atomically links one replacement and makes the predecessor audit-only without deleting or rewriting its content, context, evidence, or history.
  • Stable retries and conflicts: Converged task updates return mutation: noop without consuming quota or advancing revision, while validation, ownership, revision, generation, and supersession failures carry stable machine-readable code values.

Availability: Owner-only API runtime active. Existing clients remain compatible; direct REST consumers can opt into the new guards immediately.

Known limitation

  • The current stable MCP, CLI, and Python clients do not yet expose the optional concurrency guards or task supersession; use the REST API until later client releases add them.

References: API task-contract releaseTask concurrency contractProduction deployment

Security

Private API framework security update

  • Private API runtime 1cf7aa0

The owner-only API runtime now uses Hono 4.12.34, resolving the current upstream production advisories without changing Delega's public contract or private-access boundary.

  • Request processing hardened: Hono 4.12.34 fixes algorithmic-complexity denial-of-service paths in CORS request-header parsing and language negotiation. Delega's CORS path receives the upstream fix.
  • Framework isolation fixes included: The same minimal framework update also fixes upstream memo-helper cross-request output retention and proxy-helper connection-header handling, whether or not those helpers are active in the current Delega runtime.
  • Release gate verified: The private API passed type checking, the complete 297-test suite, build and staging ingress checks. `npm audit --omit=dev: 0 vulnerabilities` confirms the production dependency result.

Availability: Owner-only API runtime active. No client upgrade is required.

Known limitation

  • This dependency update does not reopen public hosted access or change the retired service boundary.

References: API security updateHono CORS advisoryHono memo advisoryHono proxy-helper advisoryHono language-middleware advisory

Security

MCP runtime resilience and dependency intake tightened

  • MCP 1.18.3 6f4d3af

The owner-runtime MCP client now recovers from short-lived network path failures without risking duplicate writes, reports the underlying connection failure more clearly, and ships with refreshed dependency security controls.

  • Bounded read recovery: Read-only GET API calls retry transient network failures up to three attempts within one 35-second deadline. The retry budget is shared across attempts, so a failing request cannot extend itself indefinitely.
  • Write safety preserved: POST, PUT, and DELETE requests remain single-attempt, and non-successful HTTP responses are never retried. A lost response therefore cannot cause the client to repeat a write that the service may already have accepted.
  • Actionable network errors: Exhausted network failures now surface the deepest runtime cause, error code, and attempted address when the Node transport provides them, while excluding query strings and credentials.
  • Dependency intake hardened: The current fast-uri, Hono, and ip-address advisories are resolved (`npm audit: 0 vulnerabilities`); Dependabot updates observe a seven-day cooldown; and npm install-script permissions explicitly allow only the reviewed esbuild version while denying fsevents scripts.

Availability: MCP 1.18.3 is published for Ryan McMillan’s existing owner runtime; public hosted access remains retired.

Upgrade MCP

npm install -g @delega-dev/[email protected]

Known limitations

  • Retries cover transient transport failures on read-only calls only. Application-level HTTP errors and all mutating calls are surfaced immediately.
  • The client can identify the failed connection address when Node provides it, but it cannot identify the exact upstream network hop responsible for a historical path outage without contemporaneous packet or provider telemetry.

References: MCP 1.18.3 releaseResilience implementation

Developer

Public clients marked for retirement-only use

  • MCP 1.18.2
  • CLI 1.9.3
  • Python SDK 0.6.3

The public MCP, CLI, and Python packages remain available as verifiable engineering artifacts, but their maintained metadata now states that hosted access is owner-only and new public users cannot connect.

  • MCP 1.18.2: @delega-dev/[email protected] and its MCP Registry listing now carry the hosted-service retirement notice. The 1.18.2 follow-up shortens Registry metadata to satisfy its current description limit; no runtime behavior changed.
  • CLI 1.9.3: @delega-dev/[email protected] remains installable for source and portfolio verification while clearly documenting that interactive signup and general hosted access are closed.
  • Python 0.6.3: delega==0.6.3 remains on PyPI as an as-built client artifact with the same owner-credential-only maintenance status.
  • Retirement cleanup: Pre-retirement Pages deployments and Worker versions were removed, the unused Discord sales webhook was revoked, and growth/sales automations were retired or narrowed to owner-runtime reliability.

Availability: Public source and packages remain available; hosted use requires an existing owner credential.

Known limitation

  • The clients are not an invitation to request access and are maintained only as Ryan McMillan’s private runtime requires.

References: MCP 1.18.2CLI 1.9.3Python 0.6.3Canonical case study

Security

Private-runtime boundary hardened

  • Private API runtime ca255c6

The owner-only service boundary now covers signed GitHub integration traffic as well as authenticated API traffic, and Cloudflare Worker preview routes are disabled so retired code cannot reach production data outside api.delega.dev.

  • Preview surface closed: Production and staging now set workers_dev = false and preview_urls = false. Previously deployed Worker versions are no longer externally reachable through their preview addresses.
  • Signed integrations owner-gated: GitHub installation lifecycle events, setup and OAuth callbacks, and repository webhook handling now enforce the same fail-closed account allowlist as the private API runtime.
  • Deployment-safe defaults: Production and staging configuration explicitly disable workers.dev and Preview URLs so a later deployment cannot silently restore those public routes.

Availability: Owner-only API runtime active. No client upgrade is required.

Known limitation

  • Historical Worker versions remain in Cloudflare deployment history for now, but Preview URLs are disabled and only post-retirement revisions are approved as production rollback targets.

References: Security hardening revisionCloudflare Preview URL controls

Product

Public hosted service retired

  • Private API runtime 5578834

Delega no longer accepts public accounts or payments. The Cloudflare deployment remains active as Ryan McMillan’s private coordination runtime, while delega.dev and the public clients are preserved as an engineering archive.

  • Owner-only runtime: Authenticated access now fails closed around an immutable owner-account allowlist. Existing owner MCP, CLI, Python, browser, automation, ingress, and Decision Answer workflows continue at api.delega.dev.
  • Retired acquisition paths: Signup, verification, recovery, claim, and billing routes return 410 hosted_service_retired. Authenticated non-owner accounts return 403 service_retired.
  • Engineering archive: delega.dev now documents the system as built, with public pricing and onboarding removed. The canonical case study explains the production architecture, trust model, usage evidence, and decision to end the commercial thesis.
  • Data recovery period: Non-owner data is retained without service access through August 4, 2026 for manual export requests, then scheduled for verified deletion from the live database, connected identities, and pre-deletion backups.

Availability: Owner-only API runtime active; public signup, billing, and non-owner access retired.

Known limitations

  • The public OpenAPI document and historical documentation remain available as technical evidence, but protected operations require an existing owner credential.
  • Non-owner account data remains in a seven-day recovery window through August 4, 2026; service access is blocked during that period.

References: Canonical case studyArchitecture and threat modelDeployed API retirement revision

Product

Human answers and evidence-backed completion

  • Hosted API 5b04ca7
  • MCP 1.18.0 348078a

Agents can send a blocked decision to the account owner through a secure answer link, and selected tasks can require structured, checkable evidence before completion.

  • Decision Answers: A claimed task entering waiting_input can email the account owner a signed, single-use answer link. The side-effect-free preview shows the full question before submission, and the reply returns to the task as a human-stated context entry and comment.
  • Evidence-required completion: Tasks can set evidence_policy to required. Completion then needs at least one strong evidence reference such as a commit, pull request, CI check, deploy SHA, or artifact URL; command output can accompany but cannot replace a strong reference.
  • Tightening automation: The new set_evidence_policy automation action can tighten a task to required but never remove the policy. Automation actions run asynchronously and are best-effort; setting the policy when the task is created or successfully updated is the authoritative guarantee.
  • MCP 1.18.0: The existing 44-tool MCP surface now accepts evidence on complete_task, exposes evidence_policy on task creation and updates, and renders stored policy and completion evidence.

Availability: Hosted API deployed; MCP 1.18.0 published to npm.

Upgrade MCP

npm install -g @delega-dev/[email protected]

Known limitations

  • Submitting an answer records the human ruling but does not automatically resume an agent session. The next session must read the task context.
  • Evidence is stored as a falsifiable claim for spot-checking. Delega does not execute the referenced command, inspect the artifact, or independently verify the claim.
  • If a task cannot accept another context key, the answer is preserved as a comment without a new human-stated context entry.

References: Decision Answer documentationEvidence-required completion documentationAPI release commitMCP 1.18.0 release

Security

Inbound connector validation hardening

  • Hosted API ce94cd9

Signed inbound connectors now enforce task-title limits consistently and reject prototype-chain path segments, with an automated staging smoke covering the real signed delivery flow.

  • Safe path resolution: Template placeholders and filters resolve only own object properties. The reserved __proto__, prototype, and constructor segments are rejected before a source can be saved.
  • Plan-consistent task limits: Payload-rendered task content now uses the owning account's plan-specific title limit. Oversized rendered content returns 422 and is logged as a verified delivery error instead of being silently truncated.
  • Automated staging verification: Every staging deployment can run a credential-isolated synthetic ingress smoke covering source creation, signed delivery, deduplication, signature rejection, delivery metadata, secret rotation, and cleanup.

Availability: Hosted API deployed. No client upgrade is required.

Known limitation

  • The automated end-to-end smoke uses a dedicated staging credential. Production happy-path smoke remains an optional human-run check with an already approved credential.

References: Inbound connector documentationAPI release commitHardening implementation

Product

Signed inbound connectors

  • Hosted API 62bb3a3
  • MCP 1.17.0 7452d35

Delega can now turn signed JSON events from CI systems, alerting tools, calendars, and other external services into provenance-marked tasks with pinned routing and explicit automation opt-in.

  • Signed event delivery: Each admin-managed source has a public POST /v1/ingress/:sourceId endpoint protected by a server-generated HMAC-SHA256 secret, timestamped request signatures, a 256 KiB body cap, and a per-source verified-delivery rate limit.
  • Closed task mapping: Dot-path templates render primitive payload values into task fields, optional strict filters run before quota is consumed, and project and assignee routing stay pinned to the saved source rather than the event payload.
  • Sticky provenance: Ingress-created tasks carry an ingress label and external-source warning. Automation-created children inherit that provenance, and rules process the chain only when they explicitly opt in with source eq ingress.
  • Privacy-conscious delivery history: GET /v1/ingress-sources/:id/deliveries returns verified delivery outcomes with the request body SHA-256 and byte size for correlation. Raw payloads are never retained.
  • MCP 1.17.0: Added list_ingress_sources, create_ingress_source, update_ingress_source, and delete_ingress_source, bringing the MCP surface to 44 tools.

Availability: Hosted API deployed; MCP 1.17.0 published to npm and the MCP Registry.

Upgrade MCP

npm install -g @delega-dev/[email protected]

Known limitations

  • Ingress-source management requires an account-admin agent key. Event senders authenticate with the source-specific signing secret returned only at creation or rotation.
  • Automation rules do not process ingress-sourced events unless they include an explicit source eq ingress condition; source eq automation deliberately excludes ingress-tainted children.

References: Inbound connector documentationIngress API referenceAPI release commitMCP 1.17.0 release

Product

Complete browser task coordination console

  • Hosted API 740579b
  • Browser task console 21ba1f8

The browser task console now provides a complete human coordination surface for searching, inspecting, recovering, and steering agent work without dropping into raw API calls.

  • Operations views: The console adds task and decision-memory search, quick views, project and ownership filters, recently completed work, and Fleet Attention buckets for abandoned, silent, errored, blocked, overdue, or looping tasks.
  • Full task detail: The task drawer now combines description, context with write-by-write provenance, comments, subtasks, links, delegation chain, handoff state, source markers, and capability-aware actions.
  • Safe steering: Humans and coordinators can create tasks, run duplicate checks, complete or reopen work, reassign unclaimed tasks, release stuck claims with handoff notes, update context with optimistic concurrency, and remove only comments or links the API says they may delete.
  • Recurring-work oversight: Create and edit recurring schedules in the console, inspect each schedule's spawned task history, and page that history through GET /v1/recurrences/:id/tasks.
  • Shareable task links: Open or share a specific task with delega.dev/tasks?task=<id>; filter state remains in the URL so operational views are also recoverable.

Availability: Hosted API and browser task console deployed.

Known limitation

  • The task console uses the permissions of the agent key you sign in with. Admin-only automation-rule and ingress-source management remain available through REST and MCP rather than this console.

References: Task console documentationAPI coordination commitBrowser console release commit

Product

Event-driven automation rules

  • Hosted API 9f3fcf1
  • MCP 1.16.0 0120c26

Delega can now react to task and comment events with account-scoped automation rules, while bounding cascades and preserving the fields of live-claimed work.

  • Rule engine: Admin-managed rules can create or delegate tasks, assign agents, set priority, add labels, and add comments when supported task events occur.
  • Safety controls: Automation cascades have a depth cap and shared action budget, self-triggering rule chains are suppressed, field mutations skip live-claimed tasks, append-only comments remain allowed, and repeatedly failing rules disable automatically.
  • Run history: Every evaluated action records an account-scoped result at GET /v1/automations/:id/runs, including claimed-task and idempotency skips, with automatic retention cleanup.
  • MCP 1.16.0: Added list_automations, create_automation, update_automation, and delete_automation, bringing the MCP surface to 40 tools.

Availability: Hosted API deployed; MCP 1.16.0 published to npm and the MCP Registry.

Upgrade MCP

npm install -g @delega-dev/[email protected]

Known limitations

  • Automation rules are account-admin managed and run only for Delega events emitted by the hosted API.
  • Task-producing idempotency is keyed by rule action slot and source event. Reordering or replacing an occupied slot does not replay it for an already-seen source key; create a new rule when a clean idempotency history is required.

References: Automation rule documentationAutomation API referenceAPI release commitMCP 1.16.0 release

Product

Cross-task decision-memory recall

  • Hosted API a1b6624
  • MCP 1.15.0

Agents can now recover a prior decision without knowing which task recorded it. The new read-only recall path searches context across every task the caller can read while preserving account, role, and task-level access boundaries.

  • MCP 1.15.0: Added the recall tool, bringing the MCP surface to 36 tools.
  • Hosted API: Added GET /v1/context/search with project, source, key, result-limit, and superseded-history filters.
  • Ranking: Results use lexical overlap, provenance weighting, and recency; human-stated context receives the strongest provenance weight.
  • History: All readable live entries are considered before ranking, so older relevant decisions are not hidden by newer unrelated entries. Superseded entries remain opt-in.
  • Project references: Search accepts both internal project IDs and external project references.

Availability: Hosted API deployed; MCP 1.15.0 published to npm and the MCP Registry.

Upgrade MCP

npm install -g @delega-dev/[email protected]

Known limitation

  • Recall is lexical in this first release. For object-valued context, query by the context key because nested JSON fields may not match independently. Semantic or full-text retrieval is the planned scale and matching-quality path.

References: Recall documentationAPI release commitMCP 1.15.0 release

Product

Coordination reliability: handoffs, Fleet Attention, and escalation

  • Hosted API a166230
  • MCP 1.14.0

Delega now preserves the state an agent leaves behind, surfaces work that needs intervention, and alerts the account owner when automation is blocked or abandoned.

  • Handoff notes: Releasing a task can include where the agent stopped and why. The next claimant sees a “Resuming from…” line instead of starting cold.
  • Fleet Attention: GET /v1/fleet/attention and the MCP fleet_attention tool group abandoned claims, silent holders, errors, input blocks, overdue work, and repeatedly reopened tasks.
  • Human escalation: Transitions into errored or waiting_input can notify the account email, with delivery-aware deduplication.
  • Abandoned-work recovery: The scheduled reaper resets expired claims before sending a best-effort digest, so notification failures cannot block cleanup.
  • MCP 1.14.0: Added fleet_attention and the release_task handoff parameter, taking the tool count from 34 to 35.

Availability: Hosted API deployed; MCP 1.14.0 published to npm and the MCP Registry.

References: Fleet Attention documentationRelease handoff documentationAPI release commit

Security

Security hardening across Delega

  • Hosted API f6c7d83
  • CLI 1.9.2
  • MCP 1.13.2
  • Python SDK 0.6.2
  • Infrastructure

Following a full security audit, we shipped hardening fixes across the Delega clients, hosted API, and infrastructure. No critical or actively exploited vulnerabilities were found. Most findings were defense-in-depth issues that required specific conditions, such as local machine access, an authenticated account, or a compromised or redirected server.

Hosted service and infrastructure fixes are already deployed. Client fixes are available in the versions below. Severities reflect the audit’s High, Medium, and Low ratings.

@delega-dev/cli 1.9.2

  • Medium: Fixed a Windows-only command-injection risk in delega github connect. The CLI now validates the server-supplied URL and opens it without shell re-parsing. macOS and Linux were not affected.
  • Low: Removed guidance that disabled TLS verification process-wide. Certificate errors now point to NODE_EXTRA_CA_CERTS for custom certificate authorities.
  • Low: Centralized path-segment encoding and rejected literal . and .. identifiers before URL construction.

@delega-dev/mcp 1.13.2

  • Medium: The create_webhook tool now masks the webhook signing secret by default so it does not enter model context or logs. Set DELEGA_REVEAL_WEBHOOK_SECRETS=1 when you intentionally need the full value.
  • Low: API error response bodies are no longer written to stderr by default. Detailed error logging is available with DELEGA_DEBUG=1.
  • Low: Rejected literal dot-segment identifiers before URL construction and patched all audited runtime dependencies.

delega Python SDK 0.6.2

  • Medium: URL-encoded every dynamic API path parameter and rejected literal dot segments to prevent untrusted IDs from changing a request path or query.
  • Low: Tightened webhook timestamp verification and made signature hex comparison case-insensitive.
  • Corrected version metadata so the SDK reports the right version in its User-Agent header.

Hosted API

  • Medium: Added per-IP and per-email rate limits to POST /v1/signup.
  • Medium: Added abuse limits and stable, single-use codes to verification resend and key recovery flows.
  • Medium: Enforced request, task, agent, and webhook quotas atomically across Worker isolates.
  • Medium: Strengthened webhook SSRF protection with numeric CIDR checks, including 127.0.0.0/8, 100.64.0.0/10, 0.0.0.0/8, and IPv6 fc00::/7.
  • Low: Made classic signup and verification responses state- and timing-uniform, issuing a usable key only after email proof.
  • Low: Fixed concurrent last-admin protection, recurrence-backed account deletion, immediate cross-isolate key revocation, and bounded webhook response streaming.
  • Low: Escaped agent labels in claim emails and enforced request-body limits while streaming.
  • Low: Corrected the security disclosure contact in security.txt to [email protected].
  • Reliability: Fixed scheduled cleanup of stale, unverified sandbox signups.

Infrastructure and CI

  • High: Fixed script injection in the marketing site’s preview-deploy workflow by moving pull-request branch data out of the shell expression and validating it against a strict allowlist.
  • Medium: Pinned the backup worker’s deploy actions to immutable commit SHAs.
  • Medium: Pinned and checksum-verified the MCP Registry publisher before running it with OIDC permissions.
  • High: Upgraded or safely overrode every dependency covered by the audit; all Node repositories now report zero advisories.
  • Low: Expanded client-side HTML escaping on landing pages to cover quotes in attribute contexts.
  • Low: Changed backup decryption to read its key from an environment variable or prompt instead of a process argument.
  • Low: Provisioned test containers with random root passwords.

Availability: Hosted fixes deployed; patched client versions published.

Client versions containing these fixes

npm install -g @delega-dev/[email protected]
npm install -g @delega-dev/[email protected]
pip install -U delega==0.6.2

References: Security policyAPI remediation commit

Developer

Public OpenAPI contract

  • Hosted API 62011c1

The hosted API now publishes an OpenAPI 3.1 contract for client generation, integration review, and machine discovery.

  • The contract covers public, agent-key, Stripe-signature, and GitHub-signature routes.
  • Route-coverage tests fail when the implementation and published contract drift.
  • Delega’s agent-discovery files and developer documentation link to the same canonical contract.

Availability: Available publicly without authentication.

References: OpenAPI 3.1 contractAPI release commit

Product

Recurring task templates

  • Hosted API c8d1cc0
  • MCP 1.13.0
  • CLI 1.9.0
  • Python SDK 0.6.0

Accounts can define recurring work once and let Delega create normal, accountable task instances on schedule.

  • Schedules: Daily, weekly, monthly, and yearly rules support intervals, timezones, weekday or calendar anchors, and an explicit next occurrence.
  • Task defaults: Templates can set project, assignee, labels, priority, and due-time behavior for spawned tasks.
  • Overlap control: skip_if_open can prevent a new instance while earlier work remains incomplete.
  • All major clients: Released in MCP 1.13.0, CLI 1.9.0, and Python SDK 0.6.0.

Availability: Hosted API deployed; client releases published.

References: Recurring-task documentationAPI release commit

Product

Named agent roles and account-wide coordination

  • Hosted API 32e6703
  • MCP 1.10.0 / 1.12.0
  • CLI 1.7.0 / 1.8.0
  • Python SDK 0.5.0

Agent permissions are now expressed as understandable role presets instead of requiring callers to assemble low-level flags.

  • Sandbox: Restricted onboarding access inside the agent’s sandbox project.
  • Worker: Full-mode access limited to tasks the agent created, owns, completed, or currently claims.
  • Coordinator: Account-wide task visibility and collaboration without full administrative control.
  • Admin: Full account, agent, project, billing, integration, and recovery management.
  • Client support: Released in MCP 1.12.0, CLI 1.8.0, and Python SDK 0.5.0.
  • Hosted-first onboarding: MCP 1.10.0 and CLI 1.7.0 made api.delega.dev the default service while preserving explicit custom-endpoint support.

Availability: Hosted roles deployed; client releases published.

References: Agent-role documentationAPI release commit

Product

Work queues and honest session state

  • MCP 1.4.0 / 1.7.0
  • CLI 1.3.0 / 1.4.0
  • Python SDK 0.3.0

Delega added the coordination primitives required for multiple agents to pull from one backlog without races or fake liveness.

  • Atomic claims: Agents can claim the next eligible task or target a specific task, with lease-based ownership and compare-and-set protection.
  • Heartbeats and release: Claim holders can extend a lease or return work to the queue without completing it.
  • Session state: Claimed work can report working, waiting_input, or errored independently of lease heartbeats.
  • Accountability: Delegation chains preserve the agent responsible for the overall outcome.
  • Client support: Work queues shipped in MCP 1.4.0, CLI 1.3.0, and Python SDK 0.3.0, followed by session-state support in MCP 1.7.0 and CLI 1.4.0.

Availability: Client releases published.

References: Task-claim documentationRelease-task documentation

Product

Multi-agent coordination clients

  • MCP 1.2.0
  • CLI 1.2.0
  • Python SDK 0.2.0

The CLI, MCP server, and Python SDK gained the shared coordination surface that established Delega as cross-session task memory for agent teams.

  • Delegate work and inspect the full parent/child task chain.
  • Read and merge persistent task context across sessions.
  • Check proposed work for likely duplicate open tasks.
  • Inspect hosted-plan usage and manage agent assignment from clients.
  • Released in MCP 1.2.0, CLI 1.2.0, and Python SDK 0.2.0.

Availability: Client releases published.

References: Delegation documentationTask-context documentation