@agllama/mcp 0.1.0 → 0.1.1

package/dist/tools/context.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { getApiClient, LlamaApiError } from '../api-client.js';
+import { getSessionDefaults } from './session.js';
 export const contextToolName = 'llama_context';
 export const contextToolDescription = `Get project context snapshot from Llama. Returns:
 - Project info (key, name, description)
@@ -10,15 +11,61 @@ export const contextToolDescription = `Get project context snapshot from Llama.
 - Backlog issues (first 50)
 - Team members
 
-Use this to understand the current state of a project before creating or updating issues.`;
+Supports compact mode (compact=true) for minimal response with just IDs.
+Uses session defaults if orgSlug/projectKey not provided. Use this to understand the current state of a project before creating or updating issues.`;
 export const contextToolSchema = z.object({
-    orgSlug: z.string().describe('Organization slug (e.g., "my-team")'),
-    projectKey: z.string().describe('Project key (e.g., "PROJ")'),
+    orgSlug: z
+        .string()
+        .optional()
+        .describe('Organization slug (e.g., "my-team"). Uses session default if not provided.'),
+    projectKey: z
+        .string()
+        .optional()
+        .describe('Project key (e.g., "PROJ"). Uses session default if not provided.'),
+    compact: z
+        .boolean()
+        .optional()
+        .describe('Return compact response with only essential IDs (default: false)'),
 });
 export async function executeContext(input) {
     try {
+        const session = await getSessionDefaults();
+        const orgSlug = input.orgSlug ?? session?.orgSlug;
+        const projectKey = input.projectKey ?? session?.projectKey;
+        if (!orgSlug) {
+            return JSON.stringify({
+                success: false,
+                error: 'orgSlug is required. Either provide it or set session context with llama_set_context first.',
+            });
+        }
+        if (!projectKey) {
+            return JSON.stringify({
+                success: false,
+                error: 'projectKey is required. Either provide it or set session context with llama_set_context first.',
+            });
+        }
         const client = getApiClient();
-        const context = await client.getProjectContext(input.orgSlug, input.projectKey);
+        // Record tool call
+        try {
+            await client.recordToolCall('llama_context', { orgSlug, projectKey });
+        }
+        catch {
+            // Ignore recording errors
+        }
+        const context = await client.getProjectContext(orgSlug, projectKey);
+        // Compact mode: return minimal response with just IDs
+        if (input.compact) {
+            const compactResponse = {
+                org: orgSlug,
+                project: projectKey,
+                statusIds: context.workflow.statuses.map((s) => s.id),
+                sprintId: context.activeSprint?.id || null,
+                sprintIssueCount: context.activeSprint?.issues.length || 0,
+                backlogCount: context.backlog.total,
+                memberCount: context.members.length,
+            };
+            return JSON.stringify(compactResponse);
+        }
         // Format the response for readability
         const formatted = {
             project: context.project,
@@ -57,8 +104,11 @@ export async function executeContext(input) {
                 })),
             },
             members: context.members,
+            workflows: {
+                hint: "Use llama_suggest_workflow('your task') to find saved procedures for common tasks",
+            },
         };
-        return JSON.stringify(formatted, null, 2);
+        return JSON.stringify(formatted);
     }
     catch (error) {
         if (error instanceof LlamaApiError) {
@@ -66,14 +116,14 @@ export async function executeContext(input) {
                 success: false,
                 error: `Failed to get context: ${error.message}`,
                 statusCode: error.statusCode,
-            }, null, 2);
+            });
         }
         return JSON.stringify({
             success: false,
             error: error instanceof Error
                 ? error.message
                 : 'Unknown error getting project context',
-        }, null, 2);
+        });
     }
 }
 //# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

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

package/dist/tools/documents.d.ts

@@ -0,0 +1,99 @@
+import { z } from 'zod';
+export declare const listDocsToolName = "llama_list_docs";
+export declare const listDocsToolDescription = "List documents in an organization or project.\nDocuments can be STATIC (regular docs) or SPRINT_TEMPLATE (auto-generate for sprints).\nFilter by type, status (DRAFT, PUBLISHED, ARCHIVED), or search by title.";
+export declare const listDocsToolSchema: z.ZodObject<{
+    orgSlug: z.ZodString;
+    projectKey: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["STATIC", "SPRINT_TEMPLATE"]>>;
+    status: z.ZodOptional<z.ZodEnum<["DRAFT", "PUBLISHED", "ARCHIVED"]>>;
+    search: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    orgSlug: string;
+    type?: "STATIC" | "SPRINT_TEMPLATE" | undefined;
+    status?: "DRAFT" | "PUBLISHED" | "ARCHIVED" | undefined;
+    search?: string | undefined;
+    projectKey?: string | undefined;
+}, {
+    orgSlug: string;
+    type?: "STATIC" | "SPRINT_TEMPLATE" | undefined;
+    status?: "DRAFT" | "PUBLISHED" | "ARCHIVED" | undefined;
+    search?: string | undefined;
+    projectKey?: string | undefined;
+}>;
+export type ListDocsToolInput = z.infer<typeof listDocsToolSchema>;
+export declare function executeListDocs(input: ListDocsToolInput): Promise<string>;
+export declare const getDocToolName = "llama_get_doc";
+export declare const getDocToolDescription = "Get full document content by ID.\nReturns document metadata and HTML content (can be converted to markdown).";
+export declare const getDocToolSchema: z.ZodObject<{
+    documentId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    documentId: string;
+}, {
+    documentId: string;
+}>;
+export type GetDocToolInput = z.infer<typeof getDocToolSchema>;
+export declare function executeGetDoc(input: GetDocToolInput): Promise<string>;
+export declare const createDocToolName = "llama_create_doc";
+export declare const createDocToolDescription = "Create a new document in an organization or project.\nDocuments have a unique slug (used in URLs) and can be STATIC or SPRINT_TEMPLATE.\nProvide projectKey to create a project-level doc, omit for org-level.";
+export declare const createDocToolSchema: z.ZodObject<{
+    orgSlug: z.ZodString;
+    projectKey: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    slug: z.ZodString;
+    type: z.ZodEnum<["STATIC", "SPRINT_TEMPLATE"]>;
+    description: z.ZodOptional<z.ZodString>;
+    htmlContent: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "STATIC" | "SPRINT_TEMPLATE";
+    orgSlug: string;
+    slug: string;
+    title: string;
+    projectKey?: string | undefined;
+    description?: string | undefined;
+    htmlContent?: string | undefined;
+}, {
+    type: "STATIC" | "SPRINT_TEMPLATE";
+    orgSlug: string;
+    slug: string;
+    title: string;
+    projectKey?: string | undefined;
+    description?: string | undefined;
+    htmlContent?: string | undefined;
+}>;
+export type CreateDocToolInput = z.infer<typeof createDocToolSchema>;
+export declare function executeCreateDoc(input: CreateDocToolInput): Promise<string>;
+export declare const updateDocToolName = "llama_update_doc";
+export declare const updateDocToolDescription = "Update a document's content or metadata.\nOnly include the fields you want to change.\nCan update title, content, type, or status (DRAFT/PUBLISHED/ARCHIVED).";
+export declare const updateDocToolSchema: z.ZodObject<{
+    documentId: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    htmlContent: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["STATIC", "SPRINT_TEMPLATE"]>>;
+    status: z.ZodOptional<z.ZodEnum<["DRAFT", "PUBLISHED", "ARCHIVED"]>>;
+}, "strip", z.ZodTypeAny, {
+    documentId: string;
+    type?: "STATIC" | "SPRINT_TEMPLATE" | undefined;
+    status?: "DRAFT" | "PUBLISHED" | "ARCHIVED" | undefined;
+    title?: string | undefined;
+    htmlContent?: string | undefined;
+}, {
+    documentId: string;
+    type?: "STATIC" | "SPRINT_TEMPLATE" | undefined;
+    status?: "DRAFT" | "PUBLISHED" | "ARCHIVED" | undefined;
+    title?: string | undefined;
+    htmlContent?: string | undefined;
+}>;
+export type UpdateDocToolInput = z.infer<typeof updateDocToolSchema>;
+export declare function executeUpdateDoc(input: UpdateDocToolInput): Promise<string>;
+export declare const deleteDocToolName = "llama_delete_doc";
+export declare const deleteDocToolDescription = "Delete a document permanently.\nUse with caution - this action cannot be undone.";
+export declare const deleteDocToolSchema: z.ZodObject<{
+    documentId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    documentId: string;
+}, {
+    documentId: string;
+}>;
+export type DeleteDocToolInput = z.infer<typeof deleteDocToolSchema>;
+export declare function executeDeleteDoc(input: DeleteDocToolInput): Promise<string>;
+//# sourceMappingURL=documents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAElD,eAAO,MAAM,uBAAuB,oNAEqC,CAAC;AAE1E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,wBAAsB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkD/E;AAMD,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAE9C,eAAO,MAAM,qBAAqB,iHACyC,CAAC;AAE5E,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,wBAAsB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAwC3E;AAMD,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD,eAAO,MAAM,wBAAwB,mNAEiC,CAAC;AAEvE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;EAW9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4CjF;AAMD,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD,eAAO,MAAM,wBAAwB,kKAEkC,CAAC;AAExE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAM9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0CjF;AAMD,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD,eAAO,MAAM,wBAAwB,qFACY,CAAC;AAElD,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BjF"}

package/dist/tools/documents.js

@@ -0,0 +1,252 @@
+import { z } from 'zod';
+import { getApiClient, LlamaApiError } from '../api-client.js';
+// ============================================
+// List Documents
+// ============================================
+export const listDocsToolName = 'llama_list_docs';
+export const listDocsToolDescription = `List documents in an organization or project.
+Documents can be STATIC (regular docs) or SPRINT_TEMPLATE (auto-generate for sprints).
+Filter by type, status (DRAFT, PUBLISHED, ARCHIVED), or search by title.`;
+export const listDocsToolSchema = z.object({
+    orgSlug: z.string().describe('Organization slug'),
+    projectKey: z.string().optional().describe('Project key (optional - omit for org-level docs)'),
+    type: z.enum(['STATIC', 'SPRINT_TEMPLATE']).optional().describe('Filter by document type'),
+    status: z.enum(['DRAFT', 'PUBLISHED', 'ARCHIVED']).optional().describe('Filter by status'),
+    search: z.string().optional().describe('Search documents by title'),
+});
+export async function executeListDocs(input) {
+    try {
+        const client = getApiClient();
+        const filters = {
+            type: input.type,
+            status: input.status,
+            search: input.search,
+        };
+        const documents = input.projectKey
+            ? await client.listProjectDocuments(input.orgSlug, input.projectKey, filters)
+            : await client.listOrgDocuments(input.orgSlug, filters);
+        return JSON.stringify({
+            success: true,
+            scope: input.projectKey ? 'project' : 'organization',
+            count: documents.length,
+            documents: documents.map((d) => ({
+                id: d.id,
+                title: d.title,
+                slug: d.slug,
+                description: d.description,
+                type: d.type,
+                status: d.status,
+                scope: d.scope,
+                createdBy: d.createdBy.name,
+                createdAt: d.createdAt,
+                updatedAt: d.updatedAt,
+            })),
+        }, null, 2);
+    }
+    catch (error) {
+        if (error instanceof LlamaApiError) {
+            return JSON.stringify({
+                success: false,
+                error: `Failed to list documents: ${error.message}`,
+                statusCode: error.statusCode,
+            });
+        }
+        return JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+}
+// ============================================
+// Get Document
+// ============================================
+export const getDocToolName = 'llama_get_doc';
+export const getDocToolDescription = `Get full document content by ID.
+Returns document metadata and HTML content (can be converted to markdown).`;
+export const getDocToolSchema = z.object({
+    documentId: z.string().describe('Document ID'),
+});
+export async function executeGetDoc(input) {
+    try {
+        const client = getApiClient();
+        const document = await client.getDocument(input.documentId);
+        return JSON.stringify({
+            success: true,
+            document: {
+                id: document.id,
+                title: document.title,
+                slug: document.slug,
+                description: document.description,
+                type: document.type,
+                status: document.status,
+                scope: document.scope,
+                htmlContent: document.htmlContent,
+                projectId: document.projectId,
+                orgId: document.orgId,
+                createdBy: document.createdBy,
+                createdAt: document.createdAt,
+                updatedAt: document.updatedAt,
+            },
+        });
+    }
+    catch (error) {
+        if (error instanceof LlamaApiError) {
+            return JSON.stringify({
+                success: false,
+                error: `Failed to get document: ${error.message}`,
+                statusCode: error.statusCode,
+            });
+        }
+        return JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+}
+// ============================================
+// Create Document
+// ============================================
+export const createDocToolName = 'llama_create_doc';
+export const createDocToolDescription = `Create a new document in an organization or project.
+Documents have a unique slug (used in URLs) and can be STATIC or SPRINT_TEMPLATE.
+Provide projectKey to create a project-level doc, omit for org-level.`;
+export const createDocToolSchema = z.object({
+    orgSlug: z.string().describe('Organization slug'),
+    projectKey: z.string().optional().describe('Project key (optional - omit for org-level docs)'),
+    title: z.string().describe('Document title'),
+    slug: z
+        .string()
+        .regex(/^[a-z0-9-]+$/, 'Slug must contain only lowercase letters, numbers, and hyphens')
+        .describe('URL-friendly slug (e.g., "sprint-retrospective")'),
+    type: z.enum(['STATIC', 'SPRINT_TEMPLATE']).describe('Document type'),
+    description: z.string().optional().describe('Document description'),
+    htmlContent: z.string().optional().describe('Initial HTML content'),
+});
+export async function executeCreateDoc(input) {
+    try {
+        const client = getApiClient();
+        const docInput = {
+            title: input.title,
+            slug: input.slug,
+            type: input.type,
+            description: input.description,
+            htmlContent: input.htmlContent,
+        };
+        const document = input.projectKey
+            ? await client.createProjectDocument(input.orgSlug, input.projectKey, docInput)
+            : await client.createOrgDocument(input.orgSlug, docInput);
+        return JSON.stringify({
+            success: true,
+            message: `Created ${document.type.toLowerCase()} document "${document.title}"`,
+            document: {
+                id: document.id,
+                title: document.title,
+                slug: document.slug,
+                type: document.type,
+                status: document.status,
+                scope: document.scope,
+            },
+        });
+    }
+    catch (error) {
+        if (error instanceof LlamaApiError) {
+            return JSON.stringify({
+                success: false,
+                error: `Failed to create document: ${error.message}`,
+                statusCode: error.statusCode,
+            });
+        }
+        return JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+}
+// ============================================
+// Update Document
+// ============================================
+export const updateDocToolName = 'llama_update_doc';
+export const updateDocToolDescription = `Update a document's content or metadata.
+Only include the fields you want to change.
+Can update title, content, type, or status (DRAFT/PUBLISHED/ARCHIVED).`;
+export const updateDocToolSchema = z.object({
+    documentId: z.string().describe('Document ID to update'),
+    title: z.string().optional().describe('New title'),
+    htmlContent: z.string().optional().describe('New HTML content'),
+    type: z.enum(['STATIC', 'SPRINT_TEMPLATE']).optional().describe('New document type'),
+    status: z.enum(['DRAFT', 'PUBLISHED', 'ARCHIVED']).optional().describe('New status'),
+});
+export async function executeUpdateDoc(input) {
+    try {
+        const { documentId, ...updates } = input;
+        const client = getApiClient();
+        // Build update object with only provided fields
+        const updateFields = {};
+        if (updates.title !== undefined)
+            updateFields.title = updates.title;
+        if (updates.htmlContent !== undefined)
+            updateFields.htmlContent = updates.htmlContent;
+        if (updates.type !== undefined)
+            updateFields.type = updates.type;
+        if (updates.status !== undefined)
+            updateFields.status = updates.status;
+        const document = await client.updateDocument(documentId, updateFields);
+        return JSON.stringify({
+            success: true,
+            message: `Updated document "${document.title}"`,
+            document: {
+                id: document.id,
+                title: document.title,
+                type: document.type,
+                status: document.status,
+                updatedAt: document.updatedAt,
+            },
+        });
+    }
+    catch (error) {
+        if (error instanceof LlamaApiError) {
+            return JSON.stringify({
+                success: false,
+                error: `Failed to update document: ${error.message}`,
+                statusCode: error.statusCode,
+            });
+        }
+        return JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+}
+// ============================================
+// Delete Document
+// ============================================
+export const deleteDocToolName = 'llama_delete_doc';
+export const deleteDocToolDescription = `Delete a document permanently.
+Use with caution - this action cannot be undone.`;
+export const deleteDocToolSchema = z.object({
+    documentId: z.string().describe('Document ID to delete'),
+});
+export async function executeDeleteDoc(input) {
+    try {
+        const client = getApiClient();
+        await client.deleteDocument(input.documentId);
+        return JSON.stringify({
+            success: true,
+            message: `Deleted document ${input.documentId}`,
+        });
+    }
+    catch (error) {
+        if (error instanceof LlamaApiError) {
+            return JSON.stringify({
+                success: false,
+                error: `Failed to delete document: ${error.message}`,
+                statusCode: error.statusCode,
+            });
+        }
+        return JSON.stringify({
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+}
+//# sourceMappingURL=documents.js.map

package/dist/tools/documents.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/tools/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY,eAAe,CAAC;AAEzC,eAAO,MAAM,mBAAmB,iIACgG,CAAC;AAEjI,eAAO,MAAM,cAAc;;;;;;EAOzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAyZ3D,wBAAsB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA0FvE"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/tools/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY,eAAe,CAAC;AAEzC,eAAO,MAAM,mBAAmB,iIACgG,CAAC;AAEjI,eAAO,MAAM,cAAc;;;;;;EAOzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AA+d3D,wBAAsB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA8EvE"}

package/dist/tools/help.js

@@ -11,14 +11,14 @@ export const helpToolSchema = z.object({
 const TOOL_DOCS = {
     overview: {
         title: 'Llama MCP Tools Overview',
-        description: `Llama MCP provides 41 tools for project management. Use llama_help with a topic for details.
+        description: `Llama MCP provides 46 tools for project management. Use llama_help with a topic for details.
 
 **Quick Start:**
 1. llama_connect - Test your API connection
 2. llama_context - Get project snapshot (statuses, sprints, team, backlog)
 3. Use other tools with IDs from context
 
-**Categories:** context, organizations, projects, issues, sprints, boards, backlog, comments, labels, members, links, search, workflows
+**Categories:** context, organizations, projects, issues, sprints, boards, backlog, comments, labels, members, links, search, documents, workflows
 
 **Examples:**
 - llama_help { topic: "issues" } - Learn about issue tools
@@ -191,6 +191,24 @@ Optional: summary, description, type, priority, statusId, assigneeId, sprintId,
                 description: 'Move an issue to a different column (changes status)',
                 params: 'orgSlug (required), projectKey (required), boardId (required), issueId (required), columnId (required), afterIssueId (optional), beforeIssueId (optional)',
             },
+            {
+                name: 'llama_get_board_config',
+                description: 'Get full board configuration including all column AI settings',
+                params: 'orgSlug (required), projectKey (required)',
+                use: 'View AI agent configurations for all board columns',
+            },
+            {
+                name: 'llama_update_column_config',
+                description: 'Update a column\'s AI configuration (agent type, instructions, etc.)',
+                params: 'boardId (required), columnId (required), aiEnabled (optional), agentType (optional), instructions (optional), requiredActions (optional), contextHints (optional), color (optional), icon (optional)',
+                use: 'Configure AI behavior for specific board columns',
+            },
+            {
+                name: 'llama_get_column_instructions',
+                description: 'Get AI instructions for a specific column',
+                params: 'boardId (required), columnId (required)',
+                use: 'View what an AI agent should do for issues in a column',
+            },
         ],
     },
     backlog: {
@@ -292,6 +310,52 @@ Optional: summary, description, type, priority, statusId, assigneeId, sprintId,
             },
         ],
     },
+    documents: {
+        title: 'Document Tools',
+        description: 'Manage documents at org or project level. Types: STATIC (regular) or SPRINT_TEMPLATE (auto-generate).',
+        tools: [
+            {
+                name: 'llama_list_docs',
+                description: 'List documents in an organization or project',
+                params: 'orgSlug (required), projectKey (optional: omit for org-level), type (optional: STATIC/SPRINT_TEMPLATE), status (optional: DRAFT/PUBLISHED/ARCHIVED), search (optional)',
+                example: `{
+  "orgSlug": "my-team",
+  "projectKey": "PROJ",
+  "status": "PUBLISHED"
+}`,
+            },
+            {
+                name: 'llama_get_doc',
+                description: 'Get full document content including HTML',
+                params: 'documentId (required)',
+                use: 'Reading document content or metadata',
+            },
+            {
+                name: 'llama_create_doc',
+                description: 'Create a new document',
+                params: 'orgSlug (required), projectKey (optional), title (required), slug (required: lowercase, hyphens), type (required: STATIC/SPRINT_TEMPLATE), description (optional), htmlContent (optional)',
+                example: `{
+  "orgSlug": "my-team",
+  "projectKey": "PROJ",
+  "title": "Sprint Retrospective",
+  "slug": "sprint-retro",
+  "type": "SPRINT_TEMPLATE"
+}`,
+            },
+            {
+                name: 'llama_update_doc',
+                description: 'Update document content or metadata',
+                params: 'documentId (required), title (optional), htmlContent (optional), type (optional), status (optional: DRAFT/PUBLISHED/ARCHIVED)',
+                use: 'Editing content, publishing, or archiving',
+            },
+            {
+                name: 'llama_delete_doc',
+                description: 'Permanently delete a document',
+                params: 'documentId (required)',
+                use: 'Removing a document (cannot be undone)',
+            },
+        ],
+    },
     workflows: {
         title: 'Claude Workflow Tools',
         description: 'Reusable procedures that Claude can execute with parameters.',
@@ -380,7 +444,7 @@ export async function executeHelp(input) {
                 categories: categories,
                 tip: 'Use llama_help { topic: "category" } for details on a category, or llama_help { topic: "tool_name" } for a specific tool.',
             },
-        }, null, 2);
+        });
     }
     // Check if topic is a tool name
     const normalizedTopic = topic.toLowerCase().replace(/^llama_/, '');
@@ -391,7 +455,7 @@ export async function executeHelp(input) {
             help: {
                 tool: TOOL_DETAILS[toolName],
             },
-        }, null, 2);
+        });
     }
     // Check if topic is a category
     const categoryKey = normalizedTopic;
@@ -400,7 +464,7 @@ export async function executeHelp(input) {
         return JSON.stringify({
             success: true,
             help: categoryData,
-        }, null, 2);
+        });
     }
     // Topic not found - return suggestions
     const allTools = Object.keys(TOOL_DETAILS);
@@ -416,6 +480,6 @@ export async function executeHelp(input) {
             matchingCategories: matchingCategories.length > 0 ? matchingCategories : undefined,
             availableCategories: allCategories,
         },
-    }, null, 2);
+    });
 }
 //# sourceMappingURL=help.js.map