@tdk-landscape/tdk-cli-core 1.3.170 → 1.3.172

package/cli/dist-bundle/{cold-preflight-PZKLJJGV.js → cold-preflight-GVGTFUDZ.js}

@@ -1,2 +1,2 @@
 import{createRequire as __tdkRequire}from'node:module';const require=__tdkRequire(import.meta.url);
-import{Nb as a,Ob as b,Pb as c,Qb as d,Rb as e}from"./chunk-MZBDLTO2.js";import"./chunk-42IVF3YT.js";import"./chunk-6EA4DGCY.js";export{e as assertMachineReadyOrExit,d as formatColdPreflight,a as nodeTooOld,b as requireVerifiedDockerVersions,c as runColdPreflight};
+import{Qb as a,Rb as b,Sb as c,Tb as d,Ub as e}from"./chunk-JF2COU6K.js";import"./chunk-42IVF3YT.js";import"./chunk-6EA4DGCY.js";export{e as assertMachineReadyOrExit,d as formatColdPreflight,a as nodeTooOld,b as requireVerifiedDockerVersions,c as runColdPreflight};

package/cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tdk-cli-internal",
   "private": true,
-  "version": "1.3.170",
+  "version": "1.3.172",
   "description": "TDK CLI — start services on your machine.",
   "keywords": [
     "tdk",

package/engine/schemas/service-schema.json

@@ -118,7 +118,7 @@
       "type": "string"
     },
     "appType": {
-      "description": "Resource type determining build strategy:\n• backend - Hono/Express API server\n• frontend - Vite single-page application (React, Vue, Svelte, Preact, Lit, Solid, Qwik or Vanilla TypeScript, see framework)\n• sdk - Shared library package\n• worker - Background job processor\n• migrator - Database migration runner\n• library - Shared code library\n• mcp - Model Context Protocol server (an HTTP service on Bun, run like a backend)\n• bring-your-own - Wrap an existing service. No app scaffold. Needs Dockerfile or --image.",
+      "description": "Resource type determining build strategy:\n• backend - Hono/Express API server\n• frontend - Vite single-page application (React, Vue, Svelte, Preact, Lit, Solid, Qwik or Vanilla TypeScript, see framework)\n• sdk - Shared library package\n• worker - Background job processor\n• migrator - Database migration runner\n• library - Shared code library\n• mcp - Model Context Protocol server (an HTTP service on Bun, run like a backend)\n• agent - Long-running AI agent (a Bun HTTP service with /health and /ready, run like a backend; see agent)\n• bring-your-own - Wrap an existing service. No app scaffold. Needs Dockerfile or --image.",
       "enum": [
         "backend",
         "frontend",
@@ -127,6 +127,7 @@
         "migrator",
         "library",
         "mcp",
+        "agent",
         "bring-your-own"
       ],
       "type": "string"
@@ -476,6 +477,7 @@
         "migrator",
         "library",
         "mcp",
+        "agent",
         "bring-your-own"
       ],
       "type": "string"
@@ -487,6 +489,29 @@
     "apiPath": {
       "description": "API path exposed by this resource, when applicable.",
       "type": "string"
+    },
+    "agent": {
+      "description": "Agent settings, used when appType is 'agent'. The agent runtime checkpoints its sessions; TDK provides the volume or database.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "runtime": {
+          "description": "Agent runtime scaffold. 'custom' is the default and has no vendor dependency.",
+          "type": "string",
+          "enum": [
+            "custom"
+          ]
+        },
+        "durability": {
+          "description": "files: sessions live in a named volume that tdk down keeps. postgres: sessions live in Postgres via DATABASE_URL.",
+          "type": "string",
+          "enum": [
+            "files",
+            "postgres"
+          ],
+          "default": "files"
+        }
+      }
     }
   },
   "required": [

package/engine/topologies/platform/docker/compose/compose.star

@@ -271,6 +271,17 @@ def _generate_single_backend_entry(resource_path, resource_name, res, manifest,
     no_http_healthcheck_section = NO_HTTP_HEALTHCHECK if (is_worker or health_path == None) else ""
     # Backends with a health path get it in the env, so the shared golden image's HEALTHCHECK can probe it.
     health_env = "      - TDK_HEALTH_PATH={}\n".format(health_path) if health_path else ""
+    # An agent with files durability keeps its session checkpoints in a named volume. The volume is declared at the top of the
+    # generated file (generate_app_compose_from_entries reads the marker line below), so tdk down keeps it.
+    agent_env = ""
+    agent_volume_section = ""
+    if manifest and type(manifest.get('agent')) == 'dict':
+        agent_durability = manifest['agent'].get('durability', 'files')
+        agent_env = "      - AGENT_DURABILITY={}\n".format(agent_durability)
+        if agent_durability == 'files':
+            agent_volume = res_name + '-agent-state'
+            agent_env += "      - AGENT_STATE_DIR=/var/lib/tdk-agent\n"
+            agent_volume_section = "    # tdk-agent-volume: {vol}\n    volumes:\n      - {vol}:/var/lib/tdk-agent\n".format(vol=agent_volume)
 
     if is_worker or is_proxy_disabled_byo:
         traefik_labels = '      - "traefik.enable=false"'
@@ -311,7 +322,7 @@ def _generate_single_backend_entry(resource_path, resource_name, res, manifest,
 {infisical_env}
       - RESOURCE_NAME={stack}
       - PORT={port_anchor}
-{health_env}      - INSTANCE_ID={instance_label}
+{health_env}{agent_env}      - INSTANCE_ID={instance_label}
       - NATS_QUEUE_GROUP={nats_queue}
       - TILT_DATABASE_URL={db_url_for_tilt}
       - TILT_NATS_URL={nats_url}
@@ -322,7 +333,7 @@ def _generate_single_backend_entry(resource_path, resource_name, res, manifest,
       # migration/CLI issue) without touching the generator or any service code.
       - AUTO_MIGRATE=${{AUTO_MIGRATE:-true}}
 {auth_env}{secrets_env}
-    labels:
+{agent_volume_section}    labels:
 {traefik_labels}
     networks:
       - {network_traefik_public}
@@ -368,6 +379,8 @@ def _generate_single_backend_entry(resource_path, resource_name, res, manifest,
         traefik_labels=traefik_labels,
         healthcheck_section=healthcheck_section,
         health_env=health_env,
+        agent_env=agent_env,
+        agent_volume_section=agent_volume_section,
         infisical_env=infisical_env,
         auth_env=auth_env,
         secrets_env=secrets_env,
@@ -510,6 +523,20 @@ x-frontend-memory-limit: &frontend-memory-limit
 services:
 """.format(port_anchors=port_anchors)
 
+    # Named volumes used by services (agent session state) must be declared at the top level. Services mark them with a
+    # "# tdk-agent-volume: <name>" line, so the declaration follows the services without a separate registry.
+    volume_names = []
+    for entry in resource_entries:
+        for line in entry.split("\n"):
+            if line.strip().startswith("# tdk-agent-volume: "):
+                name = line.strip()[len("# tdk-agent-volume: "):]
+                # Replicas of one agent repeat the marker; Compose rejects a duplicate key under volumes:.
+                if name not in volume_names:
+                    volume_names.append(name)
+    volumes_section = ""
+    if volume_names:
+        volumes_section = "\nvolumes:\n" + "".join(["  {}:\n".format(name) for name in volume_names])
+
     footer = """
 networks:
   {network_traefik_public}:
@@ -520,11 +547,12 @@ networks:
     external: true
   {network_infisical}:
     external: true
-""".format(
+{volumes_section}""".format(
         network_traefik_public=PlatformDockerConstants.NETWORK_TRAEFIK_PUBLIC,
         network_backend=PlatformDockerConstants.NETWORK_BACKEND,
         network_database=PlatformDockerConstants.NETWORK_DATABASE,
         network_infisical=PlatformDockerConstants.NETWORK_INFISICAL,
+        volumes_section=volumes_section,
     )
 
     content = header + "\n".join(resource_entries) + footer

package/engine/topologies/platform/docker/layers/l4_runtime_layers.star

@@ -173,6 +173,14 @@ def L4_generate_backend_runtime(res_path, port = BASE_PORT_BACKEND, cmd = 'bun r
         parts.append("RUN apk add --no-cache hugo\n")
         parts.append("USER bun\n")
 
+    # A files-durability agent keeps its checkpoints in /var/lib/tdk-agent, a named volume. Docker seeds a new volume with the
+    # image directory's owner, so create the directory owned by bun, or the agent cannot write its first checkpoint (EACCES).
+    agent_cfg = manifest.get('agent') if manifest else None
+    if type(agent_cfg) == 'dict' and agent_cfg.get('durability', 'files') == 'files':
+        parts.append("USER root\n")
+        parts.append("RUN mkdir -p /var/lib/tdk-agent && chown bun:bun /var/lib/tdk-agent\n")
+        parts.append("USER bun\n")
+
     if has_prisma_config:
         # Prisma v7 migrate deploy reads datasource.url from prisma.config.ts in CWD
         parts.append(prisma_config_copy(res_path))

package/engine/topologies/tilt/manifest/loader.star

@@ -79,6 +79,15 @@ def load_from_file(path):
     if type(manifest) == "dict" and manifest.get("appType") == "mcp":
         manifest["appType"] = "backend"
         manifest["mcp"] = True
+
+    # An `agent` resource is a long-running AI agent: a Bun HTTP service (/health, /ready, SIGTERM drain) that is built, routed
+    # and health-checked as a backend, so it reuses the backend code paths and boots health-gated. Its settings are kept under
+    # manifest["agent"] for the generators (state volume, AGENT_* environment), with durability defaulting to files.
+    if type(manifest) == "dict" and manifest.get("appType") == "agent":
+        agent = dict(manifest.get("agent") or {})
+        agent["durability"] = agent.get("durability") or "files"
+        manifest["appType"] = "backend"
+        manifest["agent"] = agent
     
     return struct(manifest=manifest, error=None)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tdk-landscape/tdk-cli-core",
-  "version": "1.3.170",
+  "version": "1.3.172",
   "description": "TDK CLI — start services on your machine.",
   "homepage": "https://tdk-landscape.github.io/tdk-website",
   "repository": {