@sentry/junior-linear 0.122.0 → 0.123.0

package/README.md

@@ -19,7 +19,7 @@ export const plugins = defineJuniorPlugins([linearPlugin()]);
 
 This package does not require a shared `LINEAR_API_KEY` or a custom OAuth app for the default setup. Each user connects their own Linear account the first time Junior calls a Linear MCP tool. Junior sends the authorization link privately and resumes the same Slack thread automatically after the user authorizes.
 
-Issue creation uses a Junior-owned tool backed by Linear's hosted MCP connection. This lets Junior link created issues to the conversation while keeping Linear's existing OAuth flow. Other Linear operations continue to use the hosted MCP tools.
+Linear operations use Linear's hosted MCP tools directly. When an issue is created through that path, Junior links it to the current conversation.
 
 Optional: set channel defaults when a Slack thread usually routes work to the same Linear destination:
 

package/dist/index.js

@@ -2,245 +2,36 @@
 import {
   defineJuniorPlugin
 } from "@sentry/junior-plugin-api";
-
-// src/tools/create-issue.ts
-import {
-  definePluginTool,
-  pluginToolResultSchema
-} from "@sentry/junior-plugin-api";
 import { z } from "zod";
-var inputSchema = z.object({
-  team: z.string().trim().min(1).describe("Linear team name or identifier."),
-  title: z.string().trim().min(1).max(60).describe("Issue title."),
-  description: z.string().describe("Issue description.").optional(),
-  priority: z.enum(["low", "medium", "high", "urgent"]).describe("Linear priority.").optional(),
-  project: z.string().trim().min(1).describe("Linear project name or identifier.").optional()
-}).strict();
-var issueSchema = z.object({
-  id: z.string().optional(),
-  identifier: z.string().optional(),
-  title: z.string().optional(),
-  url: z.string().url().optional()
-}).strict();
-var outputSchema = pluginToolResultSchema.extend({
-  ok: z.literal(true),
-  status: z.literal("success"),
-  target: z.literal("createIssue"),
-  data: z.object({
-    issue: issueSchema.nullable()
-  }),
-  issue: issueSchema.nullable()
-});
-function collectObjects(value, objects) {
-  if (!value || typeof value !== "object") {
+var saveIssueResultSchema = z.object({
+  issue: z.object({
+    identifier: z.string().trim().min(1),
+    url: z.url()
+  }).passthrough()
+}).passthrough();
+async function annotateCreatedIssue(ctx) {
+  if (ctx.tool.name !== "save_issue" || ctx.tool.arguments.id !== void 0) {
     return;
   }
-  if (Array.isArray(value)) {
-    for (const item of value) collectObjects(item, objects);
+  if (!ctx.annotations) {
     return;
   }
-  const record = value;
-  objects.push(record);
-  for (const item of Object.values(record)) collectObjects(item, objects);
-}
-function stringField(objects, field) {
-  for (const object of objects) {
-    const value = object[field];
-    if (typeof value === "string" && value.trim()) return value.trim();
-  }
-  return void 0;
-}
-function parseJsonText(text) {
-  try {
-    return JSON.parse(text);
-  } catch {
-    return void 0;
-  }
-}
-function extractIssue(result) {
-  const objects = [];
-  collectObjects(result.structuredContent, objects);
-  const textParts = result.content.flatMap(
-    (part) => part.type === "text" ? [part.text] : []
-  );
-  for (const text of textParts) {
-    collectObjects(parseJsonText(text), objects);
-  }
-  const urlMatch = textParts.map(
-    (text) => text.match(
-      /https:\/\/linear\.app\/[^\s<>)"']+\/issue\/([A-Z][A-Z0-9]*-\d+)[^\s<>)"']*/i
-    )
-  ).find((match) => match !== null);
-  const identifierMatch = textParts.map((text) => text.match(/\b[A-Z][A-Z0-9]*-\d+\b/)).find((match) => match !== null);
-  const issue = {
-    id: stringField(objects, "id"),
-    identifier: stringField(objects, "identifier") ?? urlMatch?.[1]?.toUpperCase() ?? identifierMatch?.[0],
-    title: stringField(objects, "title"),
-    url: stringField(objects, "url") ?? urlMatch?.[0]
-  };
-  const parsed = issueSchema.safeParse(
-    Object.fromEntries(
-      Object.entries(issue).filter((entry) => entry[1] !== void 0)
-    )
-  );
-  if (!parsed.success || Object.keys(parsed.data).length === 0) {
-    return null;
-  }
-  return parsed.data;
-}
-function toolResult(issue, content) {
-  const data = { issue };
-  return {
-    content,
-    details: {
-      ok: true,
-      status: "success",
-      target: "createIssue",
-      data,
-      ...data
-    }
-  };
-}
-function authorizationPendingResult() {
-  return toolResult(null, [{ type: "text", text: "Authorization pending." }]);
-}
-async function annotateIssue(ctx, issue) {
-  if (!issue?.identifier || !issue.url) {
+  const result = saveIssueResultSchema.safeParse(ctx.result.structuredContent);
+  if (!result.success) {
+    ctx.log.warn("linear.issue_annotation.skipped", {
+      "app.reason": "unexpected_save_response"
+    });
     return;
   }
-  await ctx.annotations?.upsert({
+  const identifier = result.data.issue.identifier.toUpperCase();
+  await ctx.annotations.upsert({
     kind: "resource_link",
-    key: issue.identifier.toUpperCase(),
-    label: issue.identifier.toUpperCase(),
-    url: issue.url,
+    key: identifier,
+    label: identifier,
+    url: result.data.issue.url,
     status: "open"
   });
 }
-function createLinearIssueTool(ctx) {
-  return definePluginTool({
-    description: "Create a Linear issue through Linear's hosted MCP provider and link the created issue to the current Junior conversation.",
-    inputSchema,
-    outputSchema,
-    annotations: {
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: true,
-      readOnlyHint: false,
-      title: "Create Linear issue"
-    },
-    describeProposal(input) {
-      return `Create a Linear issue in ${input.team}: ${input.title}`;
-    },
-    async execute(input, options) {
-      const mcp = ctx.mcp;
-      if (!mcp) {
-        throw new Error("Linear MCP provider is unavailable.");
-      }
-      const result = await mcp.callTool({
-        name: "save_issue",
-        arguments: input,
-        toolCallId: options.toolCallId
-      });
-      if (result.status === "authorization_pending") {
-        return authorizationPendingResult();
-      }
-      if (result.status === "error") {
-        throw new Error(result.message);
-      }
-      const issue = extractIssue(result);
-      await annotateIssue(ctx, issue);
-      return toolResult(issue, result.content);
-    }
-  });
-}
-
-// src/tools/update-issue.ts
-import {
-  definePluginTool as definePluginTool2,
-  pluginToolResultSchema as pluginToolResultSchema2
-} from "@sentry/junior-plugin-api";
-import { z as z2 } from "zod";
-var nullableName = (description) => z2.string().trim().min(1).nullable().describe(description).optional();
-var inputSchema2 = z2.object({
-  id: z2.string().trim().min(1).describe("Linear issue identifier or ID to update."),
-  assignee: nullableName(
-    'Assignee name, email, identifier, or "me". Use null to clear.'
-  ),
-  cycle: nullableName("Cycle name or identifier. Use null to clear."),
-  description: z2.string().nullable().describe("Issue description. Use null to clear.").optional(),
-  estimate: z2.number().nonnegative().nullable().describe("Issue estimate. Use null to clear.").optional(),
-  labels: z2.array(z2.string().trim().min(1)).describe("Complete set of issue label names or identifiers.").optional(),
-  priority: z2.enum(["low", "medium", "high", "urgent"]).nullable().describe("Linear priority. Use null to clear.").optional(),
-  project: nullableName("Project name or identifier. Use null to clear."),
-  state: z2.string().trim().min(1).describe("Workflow state name or identifier.").optional(),
-  team: z2.string().trim().min(1).describe("Team name or identifier.").optional(),
-  title: z2.string().trim().min(1).max(60).describe("Issue title.").optional()
-}).strict().superRefine((input, ctx) => {
-  if (Object.keys(input).every((key) => key === "id")) {
-    ctx.addIssue({
-      code: "custom",
-      message: "At least one issue field must be provided."
-    });
-  }
-});
-var outputSchema2 = pluginToolResultSchema2.extend({
-  ok: z2.literal(true),
-  status: z2.literal("success"),
-  target: z2.literal("updateIssue")
-});
-function toolResult2(content) {
-  return {
-    content,
-    details: {
-      ok: true,
-      status: "success",
-      target: "updateIssue"
-    }
-  };
-}
-function authorizationPendingResult2() {
-  return toolResult2([{ type: "text", text: "Authorization pending." }]);
-}
-function createLinearUpdateIssueTool(ctx) {
-  return definePluginTool2({
-    description: "Update an existing Linear issue through Linear's hosted MCP provider. Fetch the issue first when a change could overwrite existing fields.",
-    inputSchema: inputSchema2,
-    outputSchema: outputSchema2,
-    annotations: {
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: true,
-      readOnlyHint: false,
-      title: "Update Linear issue"
-    },
-    describeProposal(input) {
-      return `Update Linear issue ${input.id}`;
-    },
-    async execute(input, options) {
-      const mcp = ctx.mcp;
-      if (!mcp) {
-        throw new Error("Linear MCP provider is unavailable.");
-      }
-      if (await mcp.prepare() === "authorization_pending") {
-        return authorizationPendingResult2();
-      }
-      const result = await mcp.callTool({
-        name: "save_issue",
-        arguments: input,
-        toolCallId: options.toolCallId
-      });
-      if (result.status === "authorization_pending") {
-        return authorizationPendingResult2();
-      }
-      if (result.status === "error") {
-        throw new Error(result.message);
-      }
-      return toolResult2(result.content);
-    }
-  });
-}
-
-// src/plugin.ts
 function linearPlugin() {
   return defineJuniorPlugin({
     packageName: "@sentry/junior-linear",
@@ -250,18 +41,12 @@ function linearPlugin() {
       displayName: "Linear",
       mcp: {
         transport: "http",
-        url: "https://mcp.linear.app/mcp",
-        wrappedTools: ["save_issue"]
+        url: "https://mcp.linear.app/mcp"
       },
       name: "linear"
     },
     hooks: {
-      tools(ctx) {
-        return {
-          createIssue: createLinearIssueTool(ctx),
-          updateIssue: createLinearUpdateIssueTool(ctx)
-        };
-      }
+      afterMcpTool: annotateCreatedIssue
     }
   });
 }

package/dist/plugin.d.ts

@@ -1,3 +1,3 @@
 import { type PluginRegistration } from "@sentry/junior-plugin-api";
-/** Register Linear's hosted MCP provider and Junior-owned wrapper tools. */
+/** Register Linear's hosted MCP provider and conversation-link side effects. */
 export declare function linearPlugin(): PluginRegistration;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior-linear",
-  "version": "0.122.0",
+  "version": "0.123.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -23,7 +23,7 @@
   ],
   "dependencies": {
     "zod": "^4.4.3",
-    "@sentry/junior-plugin-api": "0.122.0"
+    "@sentry/junior-plugin-api": "0.123.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",

package/skills/linear/SKILL.md

@@ -67,8 +67,7 @@ If any gate fails, revise and re-check before calling the Linear create/update t
 
 6. Execute:
 
-- Create new issues with `linear_createIssue`.
-- Update existing issues with `linear_updateIssue`.
+- Create or update issues with Linear's live hosted MCP tools. Discover the current create/update tool and copy only fields justified by its live schema.
 - For updates, prefer partial changes over full rewrites. Fetch current issue state first if the mutation could overwrite structured fields or duplicate an existing comment.
 - Check for duplicates silently before creating a new issue when the request appears related to existing work.
 

package/skills/linear/references/api-surface.md

@@ -21,8 +21,8 @@ The current public docs describe support for finding, creating, and updating obj
 | Intent               | Minimum tool pattern                                                                                                         |
 | -------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
 | Inspect an issue     | Resolve the issue by key, URL, or search query, then fetch current state before answering.                                   |
-| Create an issue      | Confirm the team first, then create the issue with grounded title/body content and only the optional fields you can justify. |
-| Update fields        | Fetch current issue state first, then mutate only the requested fields.                                                      |
+| Create an issue      | Confirm the team first, then create via the live hosted MCP tools with grounded title/body content and only fields justified by the current schema. |
+| Update fields        | Fetch current issue state first, then mutate via the live hosted MCP tools with only the requested fields.                                                      |
 | Add a comment        | Resolve the exact issue first, then add a concise comment with durable links and next steps.                                 |
 | Move state or assign | Read the current issue and team workflow first when state, workflow, or assignee ambiguity could cause the wrong mutation.   |
 | Check for duplicates | Search for an existing matching issue before opening a new one when the request appears related to ongoing work.             |

package/dist/tools/create-issue.d.ts

@@ -1,67 +0,0 @@
-import { type PluginToolResultEnvelope, type ToolRegistrationHookContext } from "@sentry/junior-plugin-api";
-/** Create a Linear issue through the hosted MCP provider and link it to the conversation. */
-export declare function createLinearIssueTool(ctx: ToolRegistrationHookContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
-    team: string;
-    title: string;
-    description?: string | undefined;
-    priority?: "low" | "medium" | "high" | "urgent" | undefined;
-    project?: string | undefined;
-}, {
-    [x: string]: unknown;
-    ok: true;
-    status: "success";
-    target: "createIssue";
-    data: {
-        issue: {
-            id?: string | undefined;
-            identifier?: string | undefined;
-            title?: string | undefined;
-            url?: string | undefined;
-        } | null;
-    };
-    issue: {
-        id?: string | undefined;
-        identifier?: string | undefined;
-        title?: string | undefined;
-        url?: string | undefined;
-    } | null;
-    truncated?: boolean | undefined;
-    continuation?: {
-        arguments: Record<string, unknown>;
-        reason?: string | undefined;
-    } | undefined;
-    error?: string | {
-        kind: string;
-        message: string;
-        retryable?: boolean | undefined;
-    } | undefined;
-}, PluginToolResultEnvelope<{
-    [x: string]: unknown;
-    ok: true;
-    status: "success";
-    target: "createIssue";
-    data: {
-        issue: {
-            id?: string | undefined;
-            identifier?: string | undefined;
-            title?: string | undefined;
-            url?: string | undefined;
-        } | null;
-    };
-    issue: {
-        id?: string | undefined;
-        identifier?: string | undefined;
-        title?: string | undefined;
-        url?: string | undefined;
-    } | null;
-    truncated?: boolean | undefined;
-    continuation?: {
-        arguments: Record<string, unknown>;
-        reason?: string | undefined;
-    } | undefined;
-    error?: string | {
-        kind: string;
-        message: string;
-        retryable?: boolean | undefined;
-    } | undefined;
-}>>;

package/dist/tools/update-issue.d.ts

@@ -1,47 +0,0 @@
-import { type PluginToolResultEnvelope, type ToolRegistrationHookContext } from "@sentry/junior-plugin-api";
-/** Update a Linear issue through the hosted MCP provider. */
-export declare function createLinearUpdateIssueTool(ctx: ToolRegistrationHookContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
-    id: string;
-    assignee?: string | null | undefined;
-    cycle?: string | null | undefined;
-    description?: string | null | undefined;
-    estimate?: number | null | undefined;
-    labels?: string[] | undefined;
-    priority?: "low" | "medium" | "high" | "urgent" | null | undefined;
-    project?: string | null | undefined;
-    state?: string | undefined;
-    team?: string | undefined;
-    title?: string | undefined;
-}, {
-    [x: string]: unknown;
-    ok: true;
-    status: "success";
-    target: "updateIssue";
-    data?: unknown;
-    truncated?: boolean | undefined;
-    continuation?: {
-        arguments: Record<string, unknown>;
-        reason?: string | undefined;
-    } | undefined;
-    error?: string | {
-        kind: string;
-        message: string;
-        retryable?: boolean | undefined;
-    } | undefined;
-}, PluginToolResultEnvelope<{
-    [x: string]: unknown;
-    ok: true;
-    status: "success";
-    target: "updateIssue";
-    data?: unknown;
-    truncated?: boolean | undefined;
-    continuation?: {
-        arguments: Record<string, unknown>;
-        reason?: string | undefined;
-    } | undefined;
-    error?: string | {
-        kind: string;
-        message: string;
-        retryable?: boolean | undefined;
-    } | undefined;
-}>>;