@grackle-ai/mcp 0.19.0 → 0.21.0

package/dist/tools/project.js

@@ -0,0 +1,208 @@
+import { projectStatusToString } from "@grackle-ai/common";
+import { z } from "zod";
+import { jsonResult } from "../result-helpers.js";
+import { grpcErrorToToolResult } from "../error-handler.js";
+/** MCP tools for managing Grackle projects (CRUD + archive). */
+export const projectTools = [
+    {
+        name: "project_list",
+        group: "project",
+        description: "List all Grackle projects with their names, descriptions, repositories, and status.",
+        inputSchema: z.object({}),
+        rpcMethod: "listProjects",
+        mutating: false,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        async handler(_args, client) {
+            try {
+                const response = await client.listProjects({});
+                return jsonResult(response.projects.map((p) => ({
+                    id: p.id,
+                    name: p.name,
+                    description: p.description,
+                    repoUrl: p.repoUrl,
+                    defaultEnvironmentId: p.defaultEnvironmentId,
+                    status: projectStatusToString(p.status) || "unspecified",
+                })));
+            }
+            catch (error) {
+                return grpcErrorToToolResult(error);
+            }
+        },
+    },
+    {
+        name: "project_create",
+        group: "project",
+        description: "Create a new Grackle project with a name, optional description, repository URL, and default environment.",
+        inputSchema: z.object({
+            name: z.string().describe("Display name for the new project"),
+            description: z
+                .string()
+                .optional()
+                .describe("Optional description of the project"),
+            repoUrl: z
+                .string()
+                .optional()
+                .describe("Optional repository URL associated with the project"),
+            defaultEnvironmentId: z
+                .string()
+                .optional()
+                .describe("Optional ID of the default environment to use for this project"),
+        }),
+        rpcMethod: "createProject",
+        mutating: true,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+        async handler(args, client) {
+            try {
+                const project = await client.createProject({
+                    name: args.name,
+                    description: args.description ?? "",
+                    repoUrl: args.repoUrl ?? "",
+                    defaultEnvironmentId: args.defaultEnvironmentId ?? "",
+                });
+                return jsonResult({
+                    id: project.id,
+                    name: project.name,
+                    description: project.description,
+                    repoUrl: project.repoUrl,
+                    defaultEnvironmentId: project.defaultEnvironmentId,
+                    status: projectStatusToString(project.status) || "unspecified",
+                    createdAt: project.createdAt,
+                    updatedAt: project.updatedAt,
+                });
+            }
+            catch (error) {
+                return grpcErrorToToolResult(error);
+            }
+        },
+    },
+    {
+        name: "project_get",
+        group: "project",
+        description: "Get full details of a specific Grackle project by its unique identifier.",
+        inputSchema: z.object({
+            projectId: z.string().describe("Unique identifier of the project to retrieve"),
+        }),
+        rpcMethod: "getProject",
+        mutating: false,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        async handler(args, client) {
+            try {
+                const project = await client.getProject({
+                    id: args.projectId,
+                });
+                return jsonResult({
+                    id: project.id,
+                    name: project.name,
+                    description: project.description,
+                    repoUrl: project.repoUrl,
+                    defaultEnvironmentId: project.defaultEnvironmentId,
+                    status: projectStatusToString(project.status) || "unspecified",
+                    createdAt: project.createdAt,
+                    updatedAt: project.updatedAt,
+                });
+            }
+            catch (error) {
+                return grpcErrorToToolResult(error);
+            }
+        },
+    },
+    {
+        name: "project_update",
+        group: "project",
+        description: "Update an existing Grackle project's name, description, repository URL, or default environment.",
+        inputSchema: z.object({
+            projectId: z.string().describe("Unique identifier of the project to update"),
+            name: z
+                .string()
+                .optional()
+                .describe("New display name for the project"),
+            description: z
+                .string()
+                .optional()
+                .describe("New description for the project"),
+            repoUrl: z
+                .string()
+                .optional()
+                .describe("New repository URL for the project"),
+            defaultEnvironmentId: z
+                .string()
+                .optional()
+                .describe("New default environment ID for the project"),
+        }),
+        rpcMethod: "updateProject",
+        mutating: true,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        async handler(args, client) {
+            try {
+                const project = await client.updateProject({
+                    id: args.projectId,
+                    name: args.name,
+                    description: args.description,
+                    repoUrl: args.repoUrl,
+                    defaultEnvironmentId: args.defaultEnvironmentId,
+                });
+                return jsonResult({
+                    id: project.id,
+                    name: project.name,
+                    description: project.description,
+                    repoUrl: project.repoUrl,
+                    defaultEnvironmentId: project.defaultEnvironmentId,
+                    status: projectStatusToString(project.status) || "unspecified",
+                    createdAt: project.createdAt,
+                    updatedAt: project.updatedAt,
+                });
+            }
+            catch (error) {
+                return grpcErrorToToolResult(error);
+            }
+        },
+    },
+    {
+        name: "project_archive",
+        group: "project",
+        description: "Archive a Grackle project, marking it as inactive. This is a destructive operation.",
+        inputSchema: z.object({
+            projectId: z.string().describe("Unique identifier of the project to archive"),
+        }),
+        rpcMethod: "archiveProject",
+        mutating: true,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        async handler(args, client) {
+            try {
+                await client.archiveProject({
+                    id: args.projectId,
+                });
+                return jsonResult({ success: true });
+            }
+            catch (error) {
+                return grpcErrorToToolResult(error);
+            }
+        },
+    },
+];
+//# sourceMappingURL=project.js.map

package/dist/tools/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/tools/project.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,qFAAqF;QACvF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,SAAS,EAAE,cAAc;QACzB,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;QACD,KAAK,CAAC,OAAO,CAAC,KAA8B,EAAE,MAAsC;YAClF,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;gBAC/C,OAAO,UAAU,CACf,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC5B,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,oBAAoB,EAAE,CAAC,CAAC,oBAAoB;oBAC5C,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,aAAa;iBACzD,CAAC,CAAC,CACJ,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;KACF;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,0GAA0G;QAC5G,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YAC7D,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,qCAAqC,CAAC;YAClD,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,qDAAqD,CAAC;YAClE,oBAAoB,EAAE,CAAC;iBACpB,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,gEAAgE,CACjE;SACJ,CAAC;QACF,SAAS,EAAE,eAAe;QAC1B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,KAAK;SACrB;QACD,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,MAAsC;YACjF,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC;oBACzC,IAAI,EAAE,IAAI,CAAC,IAAc;oBACzB,WAAW,EAAG,IAAI,CAAC,WAAsB,IAAI,EAAE;oBAC/C,OAAO,EAAG,IAAI,CAAC,OAAkB,IAAI,EAAE;oBACvC,oBAAoB,EACjB,IAAI,CAAC,oBAA+B,IAAI,EAAE;iBAC9C,CAAC,CAAC;gBACH,OAAO,UAAU,CAAC;oBAChB,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;oBAClD,MAAM,EAAE,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,aAAa;oBAC9D,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;iBAC7B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,0EAA0E;QAC5E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;SAC/E,CAAC;QACF,SAAS,EAAE,YAAY;QACvB,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;QACD,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,MAAsC;YACjF,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;oBACtC,EAAE,EAAE,IAAI,CAAC,SAAmB;iBAC7B,CAAC,CAAC;gBACH,OAAO,UAAU,CAAC;oBAChB,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;oBAClD,MAAM,EAAE,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,aAAa;oBAC9D,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;iBAC7B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;KACF;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,iGAAiG;QACnG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YAC5E,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,kCAAkC,CAAC;YAC/C,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,iCAAiC,CAAC;YAC9C,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,oCAAoC,CAAC;YACjD,oBAAoB,EAAE,CAAC;iBACpB,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,4CAA4C,CAAC;SAC1D,CAAC;QACF,SAAS,EAAE,eAAe;QAC1B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;QACD,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,MAAsC;YACjF,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC;oBACzC,EAAE,EAAE,IAAI,CAAC,SAAmB;oBAC5B,IAAI,EAAE,IAAI,CAAC,IAA0B;oBACrC,WAAW,EAAE,IAAI,CAAC,WAAiC;oBACnD,OAAO,EAAE,IAAI,CAAC,OAA6B;oBAC3C,oBAAoB,EAAE,IAAI,CAAC,oBAEd;iBACd,CAAC,CAAC;gBACH,OAAO,UAAU,CAAC;oBAChB,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;oBAClD,MAAM,EAAE,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,aAAa;oBAC9D,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;iBAC7B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,qFAAqF;QACvF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;SAC9E,CAAC;QACF,SAAS,EAAE,gBAAgB;QAC3B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;QACD,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,MAAsC;YACjF,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,cAAc,CAAC;oBAC1B,EAAE,EAAE,IAAI,CAAC,SAAmB;iBAC7B,CAAC,CAAC;gBACH,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;KACF;CACF,CAAC"}

package/dist/tools/session.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../tool-registry.js";
+/** MCP tools for managing Grackle agent sessions. */
+export declare const sessionTools: ToolDefinition[];
+//# sourceMappingURL=session.d.ts.map

package/dist/tools/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/tools/session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAgB1D,qDAAqD;AACrD,eAAO,MAAM,YAAY,EAAE,cAAc,EAsOxC,CAAC"}

package/dist/tools/session.js

@@ -0,0 +1,239 @@
+import { z } from "zod";
+import { grackle, eventTypeToString } from "@grackle-ai/common";
+import { jsonResult } from "../result-helpers.js";
+import { grpcErrorToToolResult } from "../error-handler.js";
+/** Default timeout in seconds for session_attach streaming. */
+const DEFAULT_TIMEOUT_SECONDS = 30;
+/** Maximum allowed timeout in seconds for session_attach streaming. */
+const MAX_TIMEOUT_SECONDS = 300;
+/** Session statuses considered "active" for filtering purposes. */
+const ACTIVE_STATUSES = ["pending", "running", "waiting_input", "suspended"];
+/** Session statuses that indicate no further events will arrive. */
+const TERMINAL_STATUSES = ["completed", "failed", "killed"];
+/** MCP tools for managing Grackle agent sessions. */
+export const sessionTools = [
+    {
+        name: "session_spawn",
+        group: "session",
+        description: "Spawn a new AI agent session in a Grackle environment with a given prompt and optional model configuration.",
+        inputSchema: z.object({
+            environmentId: z.string().describe("The environment ID to spawn the agent in"),
+            prompt: z.string().describe("The prompt or task description for the agent"),
+            model: z.string().optional().describe("The AI model to use (e.g. claude-sonnet-4-20250514)"),
+            maxTurns: z.number().int().positive().optional().describe("Maximum number of turns the agent may take"),
+            runtime: z.string().optional().describe("The runtime to use (e.g. claude-code)"),
+            personaId: z.string().optional().describe("Persona ID to configure agent behavior"),
+        }),
+        rpcMethod: "spawnAgent",
+        mutating: true,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+        async handler(args, client) {
+            try {
+                const session = await client.spawnAgent({
+                    environmentId: args.environmentId,
+                    prompt: args.prompt,
+                    model: args.model,
+                    maxTurns: args.maxTurns,
+                    runtime: args.runtime,
+                    personaId: args.personaId,
+                });
+                return jsonResult(session);
+            }
+            catch (error) {
+                return grpcErrorToToolResult(error);
+            }
+        },
+    },
+    {
+        name: "session_resume",
+        group: "session",
+        description: "Resume a previously suspended agent session, continuing from where it left off.",
+        inputSchema: z.object({
+            sessionId: z.string().describe("The ID of the session to resume"),
+        }),
+        rpcMethod: "resumeAgent",
+        mutating: true,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+        async handler(args, client) {
+            try {
+                const session = await client.resumeAgent({
+                    sessionId: args.sessionId,
+                });
+                return jsonResult(session);
+            }
+            catch (error) {
+                return grpcErrorToToolResult(error);
+            }
+        },
+    },
+    {
+        name: "session_status",
+        group: "session",
+        description: "List agent sessions with optional filtering by environment and status. By default shows only active sessions.",
+        inputSchema: z.object({
+            environmentId: z.string().optional().describe("Filter sessions by environment ID"),
+            all: z.boolean().default(false).describe("When true, include sessions in all statuses; when false, show only active sessions"),
+        }),
+        rpcMethod: "listSessions",
+        mutating: false,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        async handler(args, client) {
+            try {
+                const response = await client.listSessions({
+                    environmentId: args.environmentId,
+                    status: "",
+                });
+                let sessions = response.sessions;
+                if (!args.all) {
+                    sessions = sessions.filter((session) => ACTIVE_STATUSES.includes(session.status));
+                }
+                const summaries = sessions.map((session) => ({
+                    id: session.id,
+                    environmentId: session.environmentId,
+                    runtime: session.runtime,
+                    status: session.status,
+                    prompt: session.prompt,
+                    model: session.model,
+                    turns: session.turns,
+                    startedAt: session.startedAt,
+                    taskId: session.taskId,
+                }));
+                return jsonResult(summaries);
+            }
+            catch (error) {
+                return grpcErrorToToolResult(error);
+            }
+        },
+    },
+    {
+        name: "session_kill",
+        group: "session",
+        description: "Terminate a running agent session immediately, stopping any in-progress work.",
+        inputSchema: z.object({
+            sessionId: z.string().describe("The ID of the session to kill"),
+        }),
+        rpcMethod: "killAgent",
+        mutating: true,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        async handler(args, client) {
+            try {
+                await client.killAgent({
+                    id: args.sessionId,
+                });
+                return jsonResult({ success: true });
+            }
+            catch (error) {
+                return grpcErrorToToolResult(error);
+            }
+        },
+    },
+    {
+        name: "session_attach",
+        group: "session",
+        description: "Attach to a running session and stream events for a limited duration. Returns collected events and whether the stream timed out.",
+        inputSchema: z.object({
+            sessionId: z.string().describe("The ID of the session to stream events from"),
+            timeoutSeconds: z.number().int().positive().max(MAX_TIMEOUT_SECONDS).default(DEFAULT_TIMEOUT_SECONDS)
+                .describe("Maximum seconds to wait for events before returning (default 30, max 300)"),
+            maxEvents: z.number().int().positive().optional().describe("Maximum number of events to collect before returning"),
+        }),
+        rpcMethod: "streamSession",
+        mutating: false,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        async handler(args, client) {
+            try {
+                const timeout = Math.min(args.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS, MAX_TIMEOUT_SECONDS);
+                const maxEvents = args.maxEvents;
+                const controller = new AbortController();
+                const timer = setTimeout(() => controller.abort(), timeout * 1000);
+                const events = [];
+                let timedOut = false;
+                try {
+                    for await (const event of client.streamSession({ id: args.sessionId }, { signal: controller.signal })) {
+                        events.push({
+                            type: eventTypeToString(event.type) || String(event.type),
+                            timestamp: event.timestamp,
+                            content: event.content,
+                        });
+                        if (maxEvents && events.length >= maxEvents) {
+                            break;
+                        }
+                        if (event.type === grackle.EventType.STATUS && TERMINAL_STATUSES.includes(event.content)) {
+                            break;
+                        }
+                    }
+                }
+                catch (err) {
+                    if (controller.signal.aborted) {
+                        timedOut = true;
+                    }
+                    else {
+                        throw err;
+                    }
+                }
+                finally {
+                    clearTimeout(timer);
+                }
+                return jsonResult({ events, timedOut });
+            }
+            catch (error) {
+                return grpcErrorToToolResult(error);
+            }
+        },
+    },
+    {
+        name: "session_send_input",
+        group: "session",
+        description: "Send a text message as input to a session that is waiting for user interaction.",
+        inputSchema: z.object({
+            sessionId: z.string().describe("The ID of the session to send input to"),
+            text: z.string().describe("The text message to send to the agent"),
+        }),
+        rpcMethod: "sendInput",
+        mutating: true,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+        async handler(args, client) {
+            try {
+                await client.sendInput({
+                    sessionId: args.sessionId,
+                    text: args.text,
+                });
+                return jsonResult({ success: true });
+            }
+            catch (error) {
+                return grpcErrorToToolResult(error);
+            }
+        },
+    },
+];
+//# sourceMappingURL=session.js.map

package/dist/tools/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/tools/session.ts"],"names":[],"mappings":"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"}

package/dist/tools/task.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../tool-registry.js";
+/** MCP tools for Grackle task management (list, create, show, update, start, delete, approve, reject, import). */
+export declare const taskTools: ToolDefinition[];
+//# sourceMappingURL=task.d.ts.map

package/dist/tools/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/tools/task.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAY1D,kHAAkH;AAClH,eAAO,MAAM,SAAS,EAAE,cAAc,EA0YrC,CAAC"}