Get Draft

Instructions

Implementation Reference

• src/tools/builtin/drafts.ts:132-190 (handler)

  Handler function for discourse_get_draft tool: parses input, fetches draft from /drafts/{key}.json, parses JSON data, formats output with preview and full JSON.

  async (input: unknown, _extra: unknown) => {
    const { draft_key, sequence } = schema.parse(input);
  
    try {
      const { client } = ctx.siteState.ensureSelectedSite();
      const params = new URLSearchParams();
      if (typeof sequence === "number") params.set("sequence", String(sequence));
  
      const url = `/drafts/${encodeURIComponent(draft_key)}.json${params.toString() ? `?${params}` : ""}`;
      const data = (await client.get(url)) as {
        draft?: string;
        draft_sequence?: number;
      };
  
      if (!data?.draft) {
        return { content: [{ type: "text", text: `No draft found for key "${draft_key}".` }] };
      }
  
      let parsedDraft: Record<string, unknown> = {};
      try {
        parsedDraft = JSON.parse(data.draft);
      } catch {
        parsedDraft = { raw: data.draft };
      }
  
      const lines = [`# Draft: \`${draft_key}\`\n`];
      lines.push(`**Sequence:** ${data.draft_sequence ?? "unknown"}`);
  
      if (parsedDraft.title) lines.push(`**Title:** ${parsedDraft.title}`);
      if (parsedDraft.categoryId) lines.push(`**Category ID:** ${parsedDraft.categoryId}`);
      if (parsedDraft.tags && Array.isArray(parsedDraft.tags)) {
        lines.push(`**Tags:** ${(parsedDraft.tags as string[]).join(", ")}`);
      }
      if (parsedDraft.action) lines.push(`**Action:** ${parsedDraft.action}`);
  
      if (parsedDraft.reply) {
        lines.push(`\n**Content:**\n${parsedDraft.reply}`);
      }
  
      lines.push("\n```json");
      lines.push(
        JSON.stringify(
          {
            draft_key,
            draft_sequence: data.draft_sequence,
            data: parsedDraft,
          },
          null,
          2
        )
      );
      lines.push("```");
  
      return { content: [{ type: "text", text: lines.join("\n") }] };
    } catch (e: unknown) {
      const msg = e instanceof Error ? e.message : String(e);
      return { content: [{ type: "text", text: `Failed to get draft: ${msg}` }], isError: true };
    }
  }

• src/tools/builtin/drafts.ts:115-122 (schema)

  Zod input schema for discourse_get_draft: requires draft_key string, optional sequence number.

  const schema = z.object({
    draft_key: z
      .string()
      .min(1)
      .max(40)
      .describe('Draft key (e.g., "new_topic", "topic_123", "new_private_message")'),
    sequence: z.number().int().min(0).optional().describe("Expected sequence number (optional)"),
  });

• src/tools/builtin/drafts.ts:114-192 (registration)

  Registration function registerGetDraft that calls server.registerTool for 'discourse_get_draft', defining title, description, schema, and handler.

  export const registerGetDraft: RegisterFn = (server, ctx, _opts) => {
    const schema = z.object({
      draft_key: z
        .string()
        .min(1)
        .max(40)
        .describe('Draft key (e.g., "new_topic", "topic_123", "new_private_message")'),
      sequence: z.number().int().min(0).optional().describe("Expected sequence number (optional)"),
    });
  
    server.registerTool(
      "discourse_get_draft",
      {
        title: "Get Draft",
        description:
          'Retrieve a specific draft by its key. Common keys: "new_topic" for new topic drafts, "topic_<id>" for reply drafts.',
        inputSchema: schema.shape,
      },
      async (input: unknown, _extra: unknown) => {
        const { draft_key, sequence } = schema.parse(input);
  
        try {
          const { client } = ctx.siteState.ensureSelectedSite();
          const params = new URLSearchParams();
          if (typeof sequence === "number") params.set("sequence", String(sequence));
  
          const url = `/drafts/${encodeURIComponent(draft_key)}.json${params.toString() ? `?${params}` : ""}`;
          const data = (await client.get(url)) as {
            draft?: string;
            draft_sequence?: number;
          };
  
          if (!data?.draft) {
            return { content: [{ type: "text", text: `No draft found for key "${draft_key}".` }] };
          }
  
          let parsedDraft: Record<string, unknown> = {};
          try {
            parsedDraft = JSON.parse(data.draft);
          } catch {
            parsedDraft = { raw: data.draft };
          }
  
          const lines = [`# Draft: \`${draft_key}\`\n`];
          lines.push(`**Sequence:** ${data.draft_sequence ?? "unknown"}`);
  
          if (parsedDraft.title) lines.push(`**Title:** ${parsedDraft.title}`);
          if (parsedDraft.categoryId) lines.push(`**Category ID:** ${parsedDraft.categoryId}`);
          if (parsedDraft.tags && Array.isArray(parsedDraft.tags)) {
            lines.push(`**Tags:** ${(parsedDraft.tags as string[]).join(", ")}`);
          }
          if (parsedDraft.action) lines.push(`**Action:** ${parsedDraft.action}`);
  
          if (parsedDraft.reply) {
            lines.push(`\n**Content:**\n${parsedDraft.reply}`);
          }
  
          lines.push("\n```json");
          lines.push(
            JSON.stringify(
              {
                draft_key,
                draft_sequence: data.draft_sequence,
                data: parsedDraft,
              },
              null,
              2
            )
          );
          lines.push("```");
  
          return { content: [{ type: "text", text: lines.join("\n") }] };
        } catch (e: unknown) {
          const msg = e instanceof Error ? e.message : String(e);
          return { content: [{ type: "text", text: `Failed to get draft: ${msg}` }], isError: true };
        }
      }
    );
  };