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

package/cli/dist/mcp/tools.js

@@ -4,6 +4,7 @@ import { spawn } from "node:child_process";
 import { closeSync, existsSync, openSync, readFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { isAbsolute, join } from "node:path";
+import { createMachineEnvelope } from "../utils/machine-output.js";
 /** A service or stack name. A leading "-" is rejected so a value can never be read as a flag. */
 const NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
 const SINCE = /^(\d+(\.\d+)?(ns|us|µs|ms|s|m|h))+$/;
@@ -131,6 +132,8 @@ export function buildUpArgs(args) {
         out.push(...only.map((name) => `--only=${name}`));
     if (flag(args.force, "force"))
         out.push("--force");
+    if (flag(args.dryRun, "dryRun"))
+        out.push("--dry-run");
     out.push("--json");
     return out;
 }
@@ -168,17 +171,13 @@ export async function startUp(args, deps = defaultUpDeps) {
     }
     child.unref();
     return {
-        data: {
-            schemaVersion: 1,
-            data: {
-                ok: true,
-                started: true,
-                pid: child.pid ?? null,
-                logFile,
-                next: "Poll the status tool until data.tilt.readiness.ready is true. Call down to stop it.",
-            },
-            errors: [],
-        },
+        data: createMachineEnvelope({
+            ok: true,
+            started: true,
+            pid: child.pid ?? null,
+            logFile,
+            next: "Poll the status tool until data.tilt.readiness.ready is true. Call down to stop it.",
+        }),
         isError: false,
     };
 }
@@ -245,6 +244,7 @@ export function createTdkTools(run = runTdkCli, up = defaultUpDeps) {
                     description: "Start only these services plus what they depend on and shared infrastructure",
                 },
                 force: { type: "boolean", description: "Replace a Tilt that is already running" },
+                dryRun: { type: "boolean", description: "Show what would be started without starting" },
                 waitSeconds: {
                     type: "number",
                     description: "How long to watch for an early failure before returning (default 15, max 60)",
@@ -255,8 +255,15 @@ export function createTdkTools(run = runTdkCli, up = defaultUpDeps) {
         {
             name: "down",
             description: "Stop the running stack, optionally selecting its project with projectPath.",
-            inputSchema: OBJECT({ projectPath: PROJECT_PATH }),
-            handler: viaCli(() => ["down", "--json"]),
+            inputSchema: OBJECT({
+                projectPath: PROJECT_PATH,
+                dryRun: { type: "boolean", description: "Show what would be stopped without stopping" },
+            }),
+            handler: viaCli((args) => [
+                "down",
+                "--json",
+                ...(flag(args.dryRun, "dryRun") ? ["--dry-run"] : []),
+            ]),
         },
         {
             name: "status",
@@ -290,5 +297,53 @@ export function createTdkTools(run = runTdkCli, up = defaultUpDeps) {
                 return ["resources", "--json", ...(stack ? [`--stack=${stack}`] : [])];
             }),
         },
+        {
+            name: "restart_resource",
+            description: "Restart a running resource in the stack (or trigger its rebuild). Set projectPath when the MCP server is not running from the project root.",
+            inputSchema: OBJECT({
+                projectPath: PROJECT_PATH,
+                resource: { type: "string", description: "Name of the resource to restart" },
+            }),
+            handler: viaCli((args) => {
+                const resource = optionalName(args.resource, "resource");
+                if (!resource)
+                    throw new Error("resource is required");
+                return ["restart", resource, "--json"];
+            }),
+        },
+        {
+            name: "list_agents",
+            description: "List AI agent resources (appType: 'agent') in the project with their stack, runtime, durability and port. Set projectPath when the MCP server is not running from the project root.",
+            inputSchema: OBJECT({
+                projectPath: PROJECT_PATH,
+                stack: { type: "string", description: "Only this stack" },
+            }),
+            handler: viaCli((args) => {
+                const stack = optionalName(args.stack, "stack");
+                return ["resources", "--type=agent", "--json", ...(stack ? [`--stack=${stack}`] : [])];
+            }),
+        },
+        {
+            name: "get_agent_sessions",
+            description: "Inspect session checkpoints from a running AI agent resource. Set projectPath when the MCP server is not running from the project root.",
+            inputSchema: OBJECT({
+                projectPath: PROJECT_PATH,
+                resource: { type: "string", description: "Name of the agent resource" },
+                sessionId: { type: "string", description: "Optional session ID to fetch" },
+            }),
+            handler: viaCli((args) => {
+                const resource = optionalName(args.resource, "resource");
+                if (!resource)
+                    throw new Error("resource is required");
+                const sessionId = optionalName(args.sessionId, "sessionId");
+                return [
+                    "agent",
+                    "sessions",
+                    resource,
+                    ...(sessionId ? [`--session-id=${sessionId}`] : []),
+                    "--json",
+                ];
+            }),
+        },
     ];
 }

package/cli/dist/utils/doctor-report.js

@@ -1,4 +1,5 @@
 import { CONTAINER_RUNTIME_CHECK } from "./constants.js";
+import { SCHEMA_VERSION } from "./machine-output.js";
 /** Wait for concurrent probes to finish even if one throws, so they can release resources. */
 export async function collectDoctorChecks(machineChecks, projectChecks) {
     const checks = [];
@@ -28,7 +29,7 @@ function containerRuntimeReachable(checks) {
 /** Produce the same readiness decision for human and machine consumers. */
 export function createDoctorReport(checks, inProject, errors = [], portPlan, host) {
     return {
-        schemaVersion: 1,
+        schemaVersion: SCHEMA_VERSION,
         data: {
             ready: errors.length === 0 &&
                 checks.every((check) => check.didPass || check.isSkipped || check.isWarning),

package/cli/dist/utils/json-output.js

@@ -1,6 +1,7 @@
 // Copyright (c) 2026 TDK Landscape contributors
 // SPDX-License-Identifier: MIT
 import { writeSync } from "node:fs";
+import { createMachineEnvelope, } from "./machine-output.js";
 /**
  * Returns an emitter that writes at most one `{schemaVersion, data, errors}` object to stdout. If the process
  * exits before anything was emitted (a preflight `process.exit`, Tilt ending early), a failure object is written
@@ -12,7 +13,7 @@ export function createJsonEmitter(failureCode, command) {
         if (emitted)
             return;
         emitted = true;
-        writeSync(1, `${JSON.stringify({ schemaVersion: 1, data, errors })}\n`);
+        writeSync(1, `${JSON.stringify(createMachineEnvelope(data, errors))}\n`);
     };
     process.once("exit", (code) => {
         emit({ ok: false }, [

package/cli/dist/utils/machine-output.js

@@ -1,8 +1,9 @@
 // Copyright (c) 2026 TDK Landscape contributors
 // SPDX-License-Identifier: MIT
 import { TdkError } from "./errors.js";
+export const SCHEMA_VERSION = 1;
 export function createMachineEnvelope(data, errors = []) {
-    return { schemaVersion: 1, data, errors };
+    return { schemaVersion: SCHEMA_VERSION, data, errors };
 }
 export function toMachineError(error) {
     if (error instanceof TdkError) {

package/cli/dist/utils/project-templates.js

@@ -25,4 +25,8 @@ export const PROJECT_TEMPLATES = {
         bundledPath: "examples/tdk-example",
         description: "Hono + Postgres + NATS worker + Vite example with a routed write path",
     },
+    "agent-stack": {
+        repo: "https://github.com/tdk-landscape/tdk-agent-stack.git",
+        description: "AI agent stack: Bun agent + MCP tool server + Postgres + NATS",
+    },
 };