@elnora-ai/linear 1.0.1 → 2.0.0

package/dist/client/linear-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"linear-client.d.ts","sourceRoot":"","sources":["../../src/client/linear-client.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,KAAK,gBAAgB,EAAa,MAAM,WAAW,CAAC;AAI7D,wBAAsB,eAAe,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAKpF;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}
+{"version":3,"file":"linear-client.d.ts","sourceRoot":"","sources":["../../src/client/linear-client.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,KAAK,gBAAgB,EAAa,MAAM,WAAW,CAAC;AAO7D,wBAAsB,eAAe,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAKpF;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAE9E;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/client/linear-client.js

@@ -2,16 +2,28 @@
 //
 // Process-wide cache so a single CLI invocation only auths + constructs once,
 // no matter how many commands invoke it. Tests can reset via resetLinearClient.
+import { createRequire } from "node:module";
 import { LinearClient } from "@linear/sdk";
 import { getApiKey } from "./auth.js";
+const pkg = createRequire(import.meta.url)("../../package.json");
+const USER_AGENT = `@elnora-ai/linear/${pkg.version}`;
 let cached = null;
 export async function getLinearClient(opts) {
     if (cached)
         return cached;
     const apiKey = await getApiKey(opts);
-    cached = new LinearClient({ apiKey });
+    cached = new LinearClient({ apiKey, headers: { "User-Agent": USER_AGENT } });
     return cached;
 }
+/**
+ * Alias for getLinearClient with allowPrompt=true.
+ *
+ * Provided so ports from the private CLI (which used a synchronous `getClient()`)
+ * can keep the same call site shape (`const client = await getClient()`).
+ */
+export async function getClient(opts) {
+    return getLinearClient({ allowPrompt: true, ...opts });
+}
 export function resetLinearClient() {
     cached = null;
 }

package/dist/client/linear-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"linear-client.js","sourceRoot":"","sources":["../../src/client/linear-client.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAyB,SAAS,EAAE,MAAM,WAAW,CAAC;AAE7D,IAAI,MAAM,GAAwB,IAAI,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAuB;IAC5D,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB;IAChC,MAAM,GAAG,IAAI,CAAC;AACf,CAAC"}
+{"version":3,"file":"linear-client.js","sourceRoot":"","sources":["../../src/client/linear-client.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAEhF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAyB,SAAS,EAAE,MAAM,WAAW,CAAC;AAE7D,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAAwB,CAAC;AACxF,MAAM,UAAU,GAAG,qBAAqB,GAAG,CAAC,OAAO,EAAE,CAAC;AAEtD,IAAI,MAAM,GAAwB,IAAI,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAuB;IAC5D,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;IAC7E,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAuB;IACtD,OAAO,eAAe,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,iBAAiB;IAChC,MAAM,GAAG,IAAI,CAAC;AACf,CAAC"}

package/dist/commands/agent-activities.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function setupAgentActivitiesCommand(program: Command): void;
+//# sourceMappingURL=agent-activities.d.ts.map

package/dist/commands/agent-activities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-activities.d.ts","sourceRoot":"","sources":["../../src/commands/agent-activities.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwEzC,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgFlE"}

package/dist/commands/agent-activities.js

@@ -0,0 +1,144 @@
+// `elnora-linear agent-activities` — streaming output an agent emits during
+// a session.
+//
+// Linear's agent framework expects a `thought` activity within 10 seconds of
+// receiving an `agentSessionEvent.created` webhook, then any number of
+// follow-ups (action / response / elicitation / error) up to ~30 minutes
+// before the session goes stale.
+import { readFileSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { AgentActivitySignal } from "@linear/sdk";
+import { getClient } from "../client/index.js";
+import { handleAsyncCommand, outputSuccess } from "../output/index.js";
+import { CliError, parseLimit, ValidationError } from "../utils/index.js";
+const VALID_TYPES = ["thought", "action", "elicitation", "response", "error"];
+function buildContent(type, body, action, parameter, resultJson) {
+    switch (type) {
+        case "thought":
+        case "elicitation":
+        case "response":
+        case "error":
+            if (!body) {
+                throw new ValidationError(`--body is required for type "${type}".`);
+            }
+            return { type, body };
+        case "action": {
+            if (!action) {
+                throw new ValidationError('--action is required for type "action".');
+            }
+            const content = { type: "action", action };
+            if (parameter !== undefined)
+                content.parameter = parameter;
+            if (resultJson !== undefined) {
+                try {
+                    content.result = JSON.parse(resultJson);
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    throw new ValidationError(`Invalid --result JSON: ${msg}`);
+                }
+            }
+            return content;
+        }
+    }
+}
+function readSignalMetadata(file) {
+    const raw = readFileSync(resolvePath(file), "utf-8");
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        throw new ValidationError(`Invalid --signal-metadata JSON: ${msg}`);
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        throw new ValidationError("--signal-metadata must be a JSON object.");
+    }
+    return parsed;
+}
+async function formatActivity(a) {
+    const session = await a.agentSession;
+    return {
+        id: a.id,
+        sessionId: session?.id ?? null,
+        signal: a.signal ?? null,
+        ephemeral: a.ephemeral ?? null,
+        content: a.content,
+        createdAt: a.createdAt,
+    };
+}
+export function setupAgentActivitiesCommand(program) {
+    const activities = program
+        .command("agent-activities")
+        .description("Manage Linear agent activities (thought / action / elicitation / response / error)");
+    activities
+        .command("list <sessionId>")
+        .description("List activities on an agent session")
+        .option("--limit <n>", "Max results", "100")
+        .action(handleAsyncCommand(async (sessionId, opts) => {
+        const client = await getClient();
+        const session = await client.agentSession(sessionId);
+        const conn = await session.activities({ first: parseLimit(opts.limit, 100) });
+        const items = await Promise.all(conn.nodes.map(formatActivity));
+        outputSuccess({ activities: items, count: items.length });
+    }));
+    activities
+        .command("get <id>")
+        .description("Get a single agent activity")
+        .action(handleAsyncCommand(async (id) => {
+        const client = await getClient();
+        const a = await client.agentActivity(id);
+        outputSuccess(await formatActivity(a));
+    }));
+    activities
+        .command("create <sessionId>")
+        .description("Emit an activity into an agent session")
+        .requiredOption("--type <type>", `One of: ${VALID_TYPES.join(", ")}`)
+        .option("--body <text>", "Body text (required for thought/elicitation/response/error)")
+        .option("--action <name>", "Action name (required for type=action)")
+        .option("--parameter <text>", "Action parameter (free-form)")
+        .option("--result <json>", "Action result (JSON string)")
+        .option("--signal <signal>", "elicitation only: select | auth | continue | stop")
+        .option("--signal-metadata <jsonFile>", "Path to JSON metadata file for signal")
+        .option("--ephemeral", "Activity disappears after the next one")
+        .action(handleAsyncCommand(async (sessionId, opts) => {
+        const type = String(opts.type);
+        if (!VALID_TYPES.includes(type)) {
+            throw new ValidationError(`Invalid --type "${type}". Must be one of: ${VALID_TYPES.join(", ")}.`);
+        }
+        if (opts.signal && type !== "elicitation") {
+            throw new ValidationError("--signal is only valid with --type elicitation.");
+        }
+        const content = buildContent(type, typeof opts.body === "string" ? opts.body : "", typeof opts.action === "string" ? opts.action : undefined, typeof opts.parameter === "string" ? opts.parameter : undefined, typeof opts.result === "string" ? opts.result : undefined);
+        const input = { agentSessionId: sessionId, content };
+        if (opts.ephemeral)
+            input.ephemeral = true;
+        if (opts.signal) {
+            const sig = String(opts.signal).toLowerCase();
+            if (sig === "select")
+                input.signal = AgentActivitySignal.Select;
+            else if (sig === "auth")
+                input.signal = AgentActivitySignal.Auth;
+            else if (sig === "continue")
+                input.signal = AgentActivitySignal.Continue;
+            else if (sig === "stop")
+                input.signal = AgentActivitySignal.Stop;
+            else
+                throw new ValidationError(`Invalid --signal "${opts.signal}". Use select, auth, continue, or stop.`);
+        }
+        if (typeof opts.signalMetadata === "string") {
+            input.signalMetadata = readSignalMetadata(opts.signalMetadata);
+        }
+        const client = await getClient();
+        const payload = await client.createAgentActivity(input);
+        if (!payload.success)
+            throw new CliError("Failed to create agent activity");
+        const activity = await payload.agentActivity;
+        outputSuccess({
+            created: true,
+            activity: activity ? await formatActivity(activity) : null,
+        });
+    }));
+}
+//# sourceMappingURL=agent-activities.js.map

package/dist/commands/agent-activities.js.map

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

package/dist/commands/agent-sessions.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function setupAgentSessionsCommand(program: Command): void;
+//# sourceMappingURL=agent-sessions.d.ts.map

package/dist/commands/agent-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-sessions.d.ts","sourceRoot":"","sources":["../../src/commands/agent-sessions.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BzC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgHhE"}

package/dist/commands/agent-sessions.js

@@ -0,0 +1,132 @@
+// `elnora-linear agent-sessions` — Linear agent framework session lifecycle.
+//
+// Sessions are auto-created by Linear when an agent is @mentioned or assigned
+// an issue. The CLI can also create them explicitly for testing the activity
+// emitter.
+import { getClient } from "../client/index.js";
+import { handleAsyncCommand, outputSuccess } from "../output/index.js";
+import { CliError, findIssueByIdentifier, parseLimit } from "../utils/index.js";
+async function formatSession(s) {
+    const [appUser, creator, issue, comment] = await Promise.all([s.appUser, s.creator, s.issue, s.comment]);
+    return {
+        id: s.id,
+        appUser: appUser?.name ?? null,
+        creator: creator?.name ?? null,
+        issue: issue?.identifier ?? null,
+        comment: comment?.id ?? null,
+        type: s.type ?? null,
+        status: s.status ?? null,
+        startedAt: s.startedAt ?? null,
+        endedAt: s.endedAt ?? null,
+        dismissedAt: s.dismissedAt ?? null,
+        externalLink: s.externalLink ?? null,
+        createdAt: s.createdAt,
+    };
+}
+export function setupAgentSessionsCommand(program) {
+    const sessions = program.command("agent-sessions").description("Manage Linear agent sessions (agent framework)");
+    sessions
+        .command("list")
+        .description("List agent sessions, newest first")
+        .option("--limit <n>", "Max results", "50")
+        .action(handleAsyncCommand(async (opts) => {
+        const client = await getClient();
+        const conn = await client.agentSessions({ first: parseLimit(opts.limit) });
+        const items = await Promise.all(conn.nodes.map(formatSession));
+        outputSuccess({ sessions: items, count: items.length });
+    }));
+    sessions
+        .command("get <id>")
+        .description("Get details of a single agent session")
+        .action(handleAsyncCommand(async (id) => {
+        const client = await getClient();
+        const session = await client.agentSession(id);
+        outputSuccess(await formatSession(session));
+    }));
+    sessions
+        .command("create-on-issue <issueId>")
+        .description("Create an agent session on an issue (issueId can be ENG-123 or UUID)")
+        .option("--external-link <url>", "External agent-hosted page URL")
+        .action(handleAsyncCommand(async (issueId, opts) => {
+        const client = await getClient();
+        const issue = await findIssueByIdentifier(client, issueId);
+        const input = { issueId: issue.id };
+        if (opts.externalLink)
+            input.externalLink = opts.externalLink;
+        const payload = await client.agentSessionCreateOnIssue(input);
+        if (!payload.success)
+            throw new CliError("Failed to create agent session");
+        const session = await payload.agentSession;
+        outputSuccess({
+            created: true,
+            session: session ? await formatSession(session) : null,
+        });
+    }));
+    sessions
+        .command("create-on-comment <commentId>")
+        .description("Create an agent session on a comment thread (commentId is a UUID)")
+        .option("--external-link <url>", "External agent-hosted page URL")
+        .action(handleAsyncCommand(async (commentId, opts) => {
+        const client = await getClient();
+        const input = { commentId };
+        if (opts.externalLink)
+            input.externalLink = opts.externalLink;
+        const payload = await client.agentSessionCreateOnComment(input);
+        if (!payload.success)
+            throw new CliError("Failed to create agent session");
+        const session = await payload.agentSession;
+        outputSuccess({
+            created: true,
+            session: session ? await formatSession(session) : null,
+        });
+    }));
+    sessions
+        .command("update <id>")
+        .description("Update an agent session (replace plan, externalLink, etc — owner-app only)")
+        .option("--external-link <url>", "Replace external link")
+        .option("--plan <jsonString>", "Replace plan (JSON object as string)")
+        .action(handleAsyncCommand(async (id, opts) => {
+        const client = await getClient();
+        const update = {};
+        if (opts.externalLink)
+            update.externalLink = opts.externalLink;
+        if (opts.plan) {
+            try {
+                update.plan = JSON.parse(opts.plan);
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                throw new CliError(`Invalid --plan JSON: ${msg}`);
+            }
+        }
+        const payload = await client.updateAgentSession(id, update);
+        if (!payload.success)
+            throw new CliError("Failed to update agent session");
+        const session = await payload.agentSession;
+        outputSuccess({
+            updated: true,
+            session: session ? await formatSession(session) : null,
+        });
+    }));
+    sessions
+        .command("update-external-url <id>")
+        .description("Add/remove/replace external URLs on a session")
+        .option("--external-link <url>", "Replace primary external link")
+        .option("--add <url>", "Add a single external URL (label = url)")
+        .option("--remove <url>", "Remove a single external URL by URL string")
+        .action(handleAsyncCommand(async (id, opts) => {
+        const client = await getClient();
+        const input = {};
+        if (opts.externalLink)
+            input.externalLink = opts.externalLink;
+        if (opts.add)
+            input.addedExternalUrls = [{ url: opts.add, label: opts.add }];
+        if (opts.remove)
+            input.removedExternalUrls = [opts.remove];
+        const payload = await client.agentSessionUpdateExternalUrl(id, input);
+        if (!payload.success)
+            throw new CliError("Failed to update external URL");
+        outputSuccess({ updated: true, id });
+    }));
+}
+//# sourceMappingURL=agent-sessions.js.map

package/dist/commands/agent-sessions.js.map

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

package/dist/commands/attachments.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function setupAttachmentsCommand(program: Command): void;
+//# sourceMappingURL=attachments.d.ts.map

package/dist/commands/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../src/commands/attachments.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmCzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgQ9D"}

package/dist/commands/attachments.js

@@ -0,0 +1,265 @@
+// `elnora-linear attachments` — manage issue attachments + integration links.
+//
+// `upload` enforces a path safety check: --file must resolve (via realpathSync)
+// under the configured upload root (default $LINEAR_UPLOAD_ROOT or cwd).
+// Symlinks pointing out of the root are rejected. A prompt-injected agent
+// cannot use `attachments upload` to exfiltrate ~/.ssh/id_rsa, ~/.aws/creds,
+// etc.
+import { readFileSync, realpathSync } from "node:fs";
+import { sep as pathSep, resolve as resolvePath } from "node:path";
+import { getClient } from "../client/index.js";
+import { handleAsyncCommand, outputSuccess } from "../output/index.js";
+import { CliError, findIssueByIdentifier, requireYes, ValidationError } from "../utils/index.js";
+function resolveUploadPath(filePath, allowRoot) {
+    const root = resolvePath(allowRoot ?? process.env.LINEAR_UPLOAD_ROOT ?? process.cwd());
+    const resolvedFile = resolvePath(filePath);
+    let realFile;
+    let realRoot;
+    try {
+        realFile = realpathSync(resolvedFile);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        throw new CliError(`Cannot resolve file "${filePath}": ${msg}`, {
+            suggestion: "Check that the file path is correct and you have read permission.",
+        });
+    }
+    try {
+        realRoot = realpathSync(root);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        throw new CliError(`Upload root "${root}" does not exist: ${msg}`);
+    }
+    if (realFile !== realRoot && !realFile.startsWith(realRoot + pathSep)) {
+        throw new ValidationError(`File "${filePath}" resolves to "${realFile}" which is outside the allowed upload root "${realRoot}".`, "Move the file under the allowed root, set LINEAR_UPLOAD_ROOT, or pass --allow-root <path>.");
+    }
+    return realFile;
+}
+export function setupAttachmentsCommand(program) {
+    const attachments = program.command("attachments").description("Manage issue attachments");
+    attachments
+        .command("get <id>")
+        .description("Get attachment details by ID")
+        .action(handleAsyncCommand(async (id) => {
+        const client = await getClient();
+        const attachment = await client.attachment(id);
+        outputSuccess({
+            id: attachment.id,
+            title: attachment.title ?? null,
+            subtitle: attachment.subtitle ?? null,
+            url: attachment.url,
+            metadata: attachment.metadata ?? null,
+            createdAt: attachment.createdAt,
+        });
+    }));
+    attachments
+        .command("list <issueId>")
+        .description("List attachments on an issue")
+        .action(handleAsyncCommand(async (issueId) => {
+        const client = await getClient();
+        const issue = await findIssueByIdentifier(client, issueId);
+        const result = await issue.attachments();
+        const items = result.nodes.map((a) => ({
+            id: a.id,
+            title: a.title ?? null,
+            subtitle: a.subtitle ?? null,
+            url: a.url,
+            createdAt: a.createdAt,
+        }));
+        outputSuccess({ attachments: items, count: items.length });
+    }));
+    attachments
+        .command("create <issueId>")
+        .description("Create an attachment on an issue")
+        .requiredOption("--url <url>", "Attachment URL")
+        .requiredOption("--title <title>", "Attachment title")
+        .option("--subtitle <subtitle>", "Attachment subtitle")
+        .option("--icon <icon>", "Icon URL or emoji")
+        .action(handleAsyncCommand(async (issueId, opts) => {
+        const client = await getClient();
+        const issue = await findIssueByIdentifier(client, issueId);
+        const input = { issueId: issue.id, url: opts.url, title: opts.title };
+        if (opts.subtitle)
+            input.subtitle = opts.subtitle;
+        if (opts.icon)
+            input.iconUrl = opts.icon;
+        const payload = await client.createAttachment(input);
+        if (!payload.success)
+            throw new CliError("Failed to create attachment");
+        const attachment = await payload.attachment;
+        outputSuccess({
+            created: true,
+            attachment: attachment ? { id: attachment.id, title: attachment.title, url: attachment.url } : null,
+        });
+    }));
+    attachments
+        .command("upload <issueId>")
+        .description("Upload a file as attachment. File must live under the allowed root (default: cwd).")
+        .requiredOption("--file <path>", "Local file path (must be under allowed root)")
+        .option("--filename <name>", "Filename (e.g., screenshot.png) — required")
+        .option("--content-type <mime>", "MIME type (e.g., image/png) — required")
+        .option("--title <title>", "Attachment title")
+        .option("--allow-root <path>", "Override allowed upload root (default: $LINEAR_UPLOAD_ROOT or cwd)")
+        .action(handleAsyncCommand(async (issueId, opts) => {
+        const filePath = resolveUploadPath(opts.file, opts.allowRoot);
+        if (!opts.filename)
+            throw new ValidationError("--filename is required.");
+        if (!opts.contentType)
+            throw new ValidationError("--content-type is required.");
+        const client = await getClient();
+        const issue = await findIssueByIdentifier(client, issueId);
+        let fileContent;
+        try {
+            fileContent = readFileSync(filePath);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            throw new CliError(`Cannot read file "${opts.file}": ${msg}`, {
+                suggestion: "Check that the file path is correct and you have read permission.",
+            });
+        }
+        const MAX_UPLOAD_SIZE = 100 * 1024 * 1024;
+        if (fileContent.length > MAX_UPLOAD_SIZE) {
+            throw new CliError(`File too large (${fileContent.length} bytes, max ${MAX_UPLOAD_SIZE})`);
+        }
+        const uploadPayload = await client.fileUpload(opts.contentType, opts.filename, fileContent.length);
+        if (!uploadPayload.success)
+            throw new CliError("Failed to get upload URL");
+        const uploadFile = uploadPayload.uploadFile;
+        if (!uploadFile)
+            throw new CliError("No upload URL returned");
+        if (!uploadFile.uploadUrl.startsWith("https://")) {
+            throw new CliError("Upload URL must use HTTPS");
+        }
+        const allowedHeaderKeys = new Set([
+            "content-type",
+            "content-disposition",
+            "cache-control",
+            "x-amz-acl",
+            "x-goog-content-length-range",
+            "x-goog-acl",
+        ]);
+        const headers = { "Content-Type": opts.contentType };
+        for (const header of uploadFile.headers) {
+            if (allowedHeaderKeys.has(header.key.toLowerCase())) {
+                headers[header.key] = header.value;
+            }
+        }
+        const uploadBody = Uint8Array.from(fileContent);
+        // Bound the upload to UPLOAD_TIMEOUT_MS so a hung S3/GCS PUT can't
+        // stall the CLI indefinitely. 100MB max body / 5 min ≈ 280 KB/s,
+        // safely below the slowest plausible connection we'd want to wait on.
+        const UPLOAD_TIMEOUT_MS = 5 * 60 * 1000;
+        let response;
+        try {
+            response = await fetch(uploadFile.uploadUrl, {
+                method: "PUT",
+                headers,
+                body: uploadBody,
+                signal: AbortSignal.timeout(UPLOAD_TIMEOUT_MS),
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new CliError(`Upload failed: ${msg}`);
+        }
+        if (!response.ok)
+            throw new CliError(`Upload failed: ${response.statusText}`);
+        const attachInput = {
+            issueId: issue.id,
+            url: uploadFile.assetUrl,
+            title: opts.title ?? opts.filename,
+        };
+        const attachPayload = await client.createAttachment(attachInput);
+        if (!attachPayload.success) {
+            throw new CliError("File was uploaded but could not be attached to the issue.", {
+                suggestion: `The file is available at ${uploadFile.assetUrl}. Try creating the attachment manually.`,
+            });
+        }
+        outputSuccess({ uploaded: true, url: uploadFile.assetUrl });
+    }));
+    attachments
+        .command("delete <id>")
+        .description("Permanently delete an attachment (irreversible — requires --yes)")
+        .option("--yes", "Confirm permanent deletion")
+        .action(handleAsyncCommand(async (id, opts) => {
+        requireYes(opts, `permanently delete attachment ${id}`);
+        const client = await getClient();
+        const payload = await client.deleteAttachment(id);
+        outputSuccess({ deleted: payload.success });
+    }));
+    async function outputLinkResult(payload, integration) {
+        if (!payload.success)
+            throw new CliError(`Failed to link ${integration} attachment`);
+        const attachment = await payload.attachment;
+        outputSuccess({
+            linked: true,
+            integration,
+            attachment: attachment ? { id: attachment.id, title: attachment.title, url: attachment.url } : null,
+        });
+    }
+    attachments
+        .command("link-github-pr <issueId>")
+        .description("Link a GitHub pull request as an integration-aware attachment")
+        .requiredOption("--url <url>", "GitHub pull request URL")
+        .action(handleAsyncCommand(async (issueId, opts) => {
+        const client = await getClient();
+        const issue = await findIssueByIdentifier(client, issueId);
+        const payload = await client.attachmentLinkGitHubPR(issue.id, opts.url);
+        await outputLinkResult(payload, "github-pr");
+    }));
+    attachments
+        .command("link-slack <issueId>")
+        .description("Link a Slack message as an integration-aware attachment")
+        .requiredOption("--url <url>", "Slack permalink (https://*.slack.com/archives/...)")
+        .action(handleAsyncCommand(async (issueId, opts) => {
+        const client = await getClient();
+        const issue = await findIssueByIdentifier(client, issueId);
+        const payload = await client.attachmentLinkSlack(issue.id, opts.url);
+        await outputLinkResult(payload, "slack");
+    }));
+    attachments
+        .command("link-jira <issueId>")
+        .description("Link a Jira issue as an integration-aware attachment")
+        .requiredOption("--jira-issue-id <id>", "Jira issue ID")
+        .action(handleAsyncCommand(async (issueId, opts) => {
+        const client = await getClient();
+        const issue = await findIssueByIdentifier(client, issueId);
+        const payload = await client.attachmentLinkJiraIssue(issue.id, opts.jiraIssueId);
+        await outputLinkResult(payload, "jira");
+    }));
+    attachments
+        .command("link-url <issueId>")
+        .description("Link an arbitrary URL as an integration-aware attachment (dedup on issueId+url)")
+        .requiredOption("--url <url>", "URL to link")
+        .action(handleAsyncCommand(async (issueId, opts) => {
+        const client = await getClient();
+        const issue = await findIssueByIdentifier(client, issueId);
+        const payload = await client.attachmentLinkURL(issue.id, opts.url);
+        await outputLinkResult(payload, "url");
+    }));
+    attachments
+        .command("link-discord <issueId>")
+        .description("Link a Discord message as an integration-aware attachment")
+        .requiredOption("--channel-id <id>", "Discord channel ID")
+        .requiredOption("--message-id <id>", "Discord message ID")
+        .requiredOption("--url <url>", "Discord message URL")
+        .action(handleAsyncCommand(async (issueId, opts) => {
+        const client = await getClient();
+        const issue = await findIssueByIdentifier(client, issueId);
+        const payload = await client.attachmentLinkDiscord(opts.channelId, issue.id, opts.messageId, opts.url);
+        await outputLinkResult(payload, "discord");
+    }));
+    attachments
+        .command("link-zendesk <issueId>")
+        .description("Link a Zendesk ticket as an integration-aware attachment")
+        .requiredOption("--ticket-id <id>", "Zendesk ticket ID")
+        .action(handleAsyncCommand(async (issueId, opts) => {
+        const client = await getClient();
+        const issue = await findIssueByIdentifier(client, issueId);
+        const payload = await client.attachmentLinkZendesk(issue.id, opts.ticketId);
+        await outputLinkResult(payload, "zendesk");
+    }));
+}
+//# sourceMappingURL=attachments.js.map