charness 0.0.0-stage → 3.0.0

package/dist/connectors/jira/issueBlocks.js

@@ -0,0 +1,182 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIssueBlockText = getIssueBlockText;
+exports.buildIssueBlocks = buildIssueBlocks;
+const crypto_1 = require("crypto");
+const adf_1 = require("./adf");
+const issueContext_1 = require("./issueContext");
+const mediaPlaceholders_1 = require("./mediaPlaceholders");
+const promptText_1 = require("./promptText");
+const emptyBodyText = '(empty)';
+const noneBodyText = '(none)';
+const notReferencedText = 'not referenced in the text';
+const descriptionLocation = 'description';
+/** Properties of a field value that name it, in the order they are tried: a user, an option, a version or component. */
+const namedValueProperties = ['displayName', 'value', 'name'];
+/** @description The block as the prompt prints it; `stateNote` (`new`, `changed since your last prompt`, …) follows the heading. */
+function getIssueBlockText(block, stateNote) {
+    return `${block.heading}${stateNote ? ` (${stateNote})` : ''}:\n${block.body}`;
+}
+function getHash(text) {
+    return (0, crypto_1.createHash)('sha256').update(text).digest('hex');
+}
+function createBlock(key, kind, heading, body, fullText = body) {
+    return { key, kind, heading, body, fullText, hash: getHash(`${heading}\n${body}`) };
+}
+/** `PROJ-5 "summary" (Status)`: what another issue is called. */
+function getIssueReferenceText(reference) {
+    const summary = (0, promptText_1.getSingleLineText)(reference.fields?.summary ?? '');
+    const statusName = (0, promptText_1.getSingleLineText)(reference.fields?.status?.name ?? '');
+    return [(0, promptText_1.getSingleLineText)(reference.key), summary ? `"${summary}"` : '', statusName ? `(${statusName})` : ''].filter((part) => part !== '').join(' ');
+}
+function getExtraFieldValueText(value) {
+    if (value === undefined || value === null)
+        return '';
+    if (typeof value === 'string')
+        return (0, promptText_1.getSingleLineText)(value);
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return value.toString();
+    if (Array.isArray(value))
+        return value.map(getExtraFieldValueText).filter((text) => text !== '').join(', ');
+    const document = adf_1.adfNodeSchema.safeParse(value);
+    if (document.success && document.data.type === 'doc')
+        return (0, promptText_1.getSingleLineText)((0, adf_1.getAdfText)(document.data));
+    for (const propertyName of namedValueProperties) {
+        const named = value[propertyName];
+        if (typeof named === 'string')
+            return (0, promptText_1.getSingleLineText)(named);
+    }
+    return (0, promptText_1.getSingleLineText)(JSON.stringify(value));
+}
+/** A `Label: value` line, or nothing for a field that has no value. */
+function getFieldLine(label, value) {
+    return value === '' ? [] : [`${label}: ${value}`];
+}
+function getNamesText(items) {
+    return (items ?? []).map((item) => (0, promptText_1.getSingleLineText)(item.name)).filter((name) => name !== '').join(', ');
+}
+function getFieldsBlock(context, extraFields) {
+    const { fields, rawFields } = context.issue;
+    const lines = [
+        ...getFieldLine('Summary', (0, promptText_1.getSingleLineText)(fields.summary ?? '') || '(no summary)'),
+        ...getFieldLine('Type', (0, promptText_1.getSingleLineText)(fields.issuetype?.name ?? '')),
+        ...getFieldLine('Priority', (0, promptText_1.getSingleLineText)(fields.priority?.name ?? '')),
+        ...getFieldLine('Status', (0, promptText_1.getSingleLineText)(fields.status?.name ?? '') || 'unknown'),
+        ...getFieldLine('Reporter', fields.reporter ? (0, promptText_1.getAccountName)(fields.reporter) : ''),
+        ...getFieldLine('Parent', fields.parent ? getIssueReferenceText(fields.parent) : ''),
+        ...getFieldLine('Fix versions', getNamesText(fields.fixVersions)),
+        ...getFieldLine('Labels', (fields.labels ?? []).map(promptText_1.getSingleLineText).filter((label) => label !== '').join(', ')),
+        ...getFieldLine('Components', getNamesText(fields.components)),
+        ...extraFields.flatMap((extraField) => getFieldLine((0, promptText_1.getSingleLineText)(extraField.name), getExtraFieldValueText(rawFields?.[extraField.id]))),
+    ];
+    return createBlock('fields', 'fields', 'Fields', lines.join('\n'));
+}
+function getHierarchyBlock(context) {
+    const isParent = (context.issue.fields.issuetype?.hierarchyLevel ?? 0) >= issueContext_1.jiraParentHierarchyLevel;
+    const items = isParent ? context.children : (context.issue.fields.subtasks ?? []);
+    const heading = `${isParent ? 'Child issues' : 'Sub-tasks'} (${items.length})`;
+    return createBlock('hierarchy', 'hierarchy', heading, items.length === 0 ? noneBodyText : items.map((item) => `- ${getIssueReferenceText(item)}`).join('\n'));
+}
+function getIssueLinkText(link) {
+    const farIssue = link.outwardIssue ?? link.inwardIssue;
+    if (!farIssue)
+        return [];
+    const phrase = (0, promptText_1.getSingleLineText)(link.outwardIssue ? link.type.outward : link.type.inward);
+    return [`- ${phrase} ${getIssueReferenceText(farIssue)}`];
+}
+function getLinksBlock(context) {
+    const lines = [
+        ...(context.issue.fields.issuelinks ?? []).flatMap(getIssueLinkText),
+        ...context.remoteLinks.map((link) => {
+            const title = (0, promptText_1.getSingleLineText)(link.object.title ?? '');
+            return `- web link: ${title ? `"${title}" ` : ''}${(0, promptText_1.getSingleLineText)(link.object.url)}`;
+        }),
+    ];
+    return createBlock('links', 'links', 'Links', lines.length === 0 ? noneBodyText : lines.join('\n'));
+}
+function getAttachmentLine(attachment, locations) {
+    const details = [
+        (0, promptText_1.getSingleLineText)(attachment.mimeType ?? ''),
+        attachment.size === undefined ? '' : `${attachment.size} bytes`,
+        attachment.author ? `by ${(0, promptText_1.getAccountName)(attachment.author)}` : '',
+        (0, promptText_1.getSingleLineText)(attachment.created ?? ''),
+    ].filter((detail) => detail !== '');
+    const detailsText = details.length > 0 ? ` (${details.join(', ')})` : '';
+    const referencedText = locations.length > 0 ? `referenced in ${locations.join(', ')}` : notReferencedText;
+    return `- ${attachment.id} ${(0, promptText_1.getSingleLineText)(attachment.filename)}${detailsText} — ${referencedText}`;
+}
+function getAttachmentsBlock(attachments, locationsByAttachmentId) {
+    const lines = attachments.map((attachment) => getAttachmentLine(attachment, locationsByAttachmentId.get(attachment.id) ?? []));
+    return createBlock('attachments', 'attachments', `Attachments (${attachments.length})`, lines.length === 0 ? noneBodyText : lines.join('\n'));
+}
+/** `[restricted to <role or group>]` and `[internal]` (a Service Management internal note): who may NOT be told what this says. */
+function getCommentVisibilityMarker(comment) {
+    const markers = [
+        ...(comment.visibility ? [`[restricted to ${(0, promptText_1.getSingleLineText)(comment.visibility.value)}]`] : []),
+        ...(comment.jsdPublic === false ? ['[internal]'] : []),
+    ];
+    return markers.join(' ');
+}
+function getCommentBlock(comment, text, aiAccountId) {
+    const marker = getCommentVisibilityMarker(comment);
+    const id = (0, promptText_1.getSingleLineText)(comment.id);
+    const authorName = (0, promptText_1.getAccountName)(comment.author);
+    const created = (0, promptText_1.getSingleLineText)(comment.created);
+    const heading = `Comment ${id} by ${authorName}, ${created}${marker ? ` ${marker}` : ''}`;
+    const updateAuthorId = comment.updateAuthor?.accountId;
+    return {
+        key: `comment:${comment.id}`,
+        kind: 'comment',
+        heading,
+        body: (0, promptText_1.getQuotedText)(text || emptyBodyText),
+        fullText: text,
+        // Author and date never change; a save that changed nothing must not resend the comment.
+        hash: getHash(`${marker}\n${text}`),
+        comment: {
+            label: `comment ${id} by ${authorName} from ${created}`,
+            editNote: `edited ${(0, promptText_1.getSingleLineText)(comment.updated ?? '') || 'at an unknown time'} by ${(0, promptText_1.getAccountName)(comment.updateAuthor ?? comment.author)}`,
+            isOwn: comment.author?.accountId === aiAccountId && (updateAuthorId === undefined || updateAuthorId === aiAccountId),
+        },
+    };
+}
+/** Oldest first; Jira sorts them already, a tie keeps Jira's order. */
+function getCommentsOldestFirst(comments) {
+    return [...comments].sort((left, right) => Date.parse(left.created) - Date.parse(right.created));
+}
+/**
+ * @description The issue as blocks, in prompt order. Media in the description
+ * and the comments become placeholders naming their attachment (C9); the
+ * attachments block then says where each file is referenced.
+ */
+function buildIssueBlocks(context, extraFields, aiAccountId) {
+    const attachments = [...(context.issue.fields.attachment ?? [])].sort((left, right) => Number(left.id) - Number(right.id));
+    const comments = getCommentsOldestFirst(context.comments);
+    const attachmentIdByMediaId = new Map([
+        ...(0, mediaPlaceholders_1.getAttachmentIdsByMediaId)(context.issue.renderedFields?.description),
+        ...comments.flatMap((comment) => [...(0, mediaPlaceholders_1.getAttachmentIdsByMediaId)(comment.renderedBody)]),
+    ]);
+    const locationsByAttachmentId = new Map();
+    const getResolver = (location) => (0, mediaPlaceholders_1.createMediaResolver)({
+        attachments,
+        attachmentIdByMediaId,
+        onResolved: (attachmentIds) => {
+            for (const attachmentId of attachmentIds) {
+                const locations = locationsByAttachmentId.get(attachmentId) ?? [];
+                if (!locations.includes(location))
+                    locationsByAttachmentId.set(attachmentId, [...locations, location]);
+            }
+        },
+    });
+    const descriptionText = (0, adf_1.getAdfText)(context.issue.fields.description, getResolver(descriptionLocation));
+    const descriptionBlock = createBlock('description', 'description', 'Description', (0, promptText_1.getQuotedText)(descriptionText || emptyBodyText), descriptionText);
+    const commentBlocks = comments.map((comment) => getCommentBlock(comment, (0, adf_1.getAdfText)(comment.body, getResolver(`comment ${comment.id}`)), aiAccountId));
+    return [
+        getFieldsBlock(context, extraFields),
+        descriptionBlock,
+        getHierarchyBlock(context),
+        getLinksBlock(context),
+        getAttachmentsBlock(attachments, locationsByAttachmentId),
+        ...commentBlocks,
+    ];
+}
+//# sourceMappingURL=issueBlocks.js.map

package/dist/connectors/jira/issueBlocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issueBlocks.js","sourceRoot":"","sources":["../../../src/connectors/jira/issueBlocks.ts"],"names":[],"mappings":";;AA8DA,8CAEC;AA6ID,4CA8BC;AA3OD,mCAAoC;AACpC,+BAA0E;AAG1E,iDAA0D;AAC1D,2DAAqF;AACrF,6CAAgF;AAgDhF,MAAM,aAAa,GAAG,SAAS,CAAC;AAChC,MAAM,YAAY,GAAG,QAAQ,CAAC;AAC9B,MAAM,iBAAiB,GAAG,4BAA4B,CAAC;AACvD,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAC1C,wHAAwH;AACxH,MAAM,oBAAoB,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAEvE,oIAAoI;AACpI,SAAgB,iBAAiB,CAAC,KAAiB,EAAE,SAAkB;IACrE,OAAO,GAAG,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;AACjF,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,WAAW,CAAC,GAAW,EAAE,IAAoB,EAAE,OAAe,EAAE,IAAY,EAAE,QAAQ,GAAG,IAAI;IACpG,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,OAAO,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;AACtF,CAAC;AAED,iEAAiE;AACjE,SAAS,qBAAqB,CAAC,SAA6B;IAC1D,MAAM,OAAO,GAAG,IAAA,8BAAiB,EAAC,SAAS,CAAC,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,IAAA,8BAAiB,EAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAC3E,OAAO,CAAC,IAAA,8BAAiB,EAAC,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxJ,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAoC;IAClE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAA,8BAAiB,EAAC,KAAK,CAAC,CAAC;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IACrF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5G,MAAM,QAAQ,GAAG,mBAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAA,8BAAiB,EAAC,IAAA,gBAAU,EAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1G,KAAK,MAAM,YAAY,IAAI,oBAAoB,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;QAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAA,8BAAiB,EAAC,KAAK,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,IAAA,8BAAiB,EAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,uEAAuE;AACvE,SAAS,YAAY,CAAC,KAAa,EAAE,KAAa;IAChD,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,KAAK,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,YAAY,CAAC,KAAkD;IACtE,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,8BAAiB,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5G,CAAC;AAED,SAAS,cAAc,CAAC,OAAyB,EAAE,WAAsC;IACvF,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5C,MAAM,KAAK,GAAG;QACZ,GAAG,YAAY,CAAC,SAAS,EAAE,IAAA,8BAAiB,EAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,cAAc,CAAC;QACrF,GAAG,YAAY,CAAC,MAAM,EAAE,IAAA,8BAAiB,EAAC,MAAM,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QACxE,GAAG,YAAY,CAAC,UAAU,EAAE,IAAA,8BAAiB,EAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC3E,GAAG,YAAY,CAAC,QAAQ,EAAE,IAAA,8BAAiB,EAAC,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC,IAAI,SAAS,CAAC;QACpF,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAA,2BAAc,EAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,GAAG,YAAY,CAAC,cAAc,EAAE,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACjE,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,8BAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClH,GAAG,YAAY,CAAC,YAAY,EAAE,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9D,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,YAAY,CAAC,IAAA,8BAAiB,EAAC,UAAU,CAAC,IAAI,CAAC,EAAE,sBAAsB,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;KAC7I,CAAC;IACF,OAAO,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAyB;IAClD,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,IAAI,CAAC,CAAC,IAAI,uCAAwB,CAAC;IACnG,MAAM,KAAK,GAAkC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IACjH,MAAM,OAAO,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;IAC/E,OAAO,WAAW,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChK,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAmB;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,WAAW,CAAC;IACvD,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,IAAA,8BAAiB,EAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3F,OAAO,CAAC,KAAK,MAAM,IAAI,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,aAAa,CAAC,OAAyB;IAC9C,MAAM,KAAK,GAAG;QACZ,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;QACpE,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAClC,MAAM,KAAK,GAAG,IAAA,8BAAiB,EAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YACzD,OAAO,eAAe,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAA,8BAAiB,EAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1F,CAAC,CAAC;KACH,CAAC;IACF,OAAO,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACtG,CAAC;AAED,SAAS,iBAAiB,CAAC,UAA0B,EAAE,SAA4B;IACjF,MAAM,OAAO,GAAG;QACd,IAAA,8BAAiB,EAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC5C,UAAU,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,QAAQ;QAC/D,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAA,2BAAc,EAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QAClE,IAAA,8BAAiB,EAAC,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC;KAC5C,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAC1G,OAAO,KAAK,UAAU,CAAC,EAAE,IAAI,IAAA,8BAAiB,EAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,WAAW,MAAM,cAAc,EAAE,CAAC;AAC1G,CAAC;AAED,SAAS,mBAAmB,CAAC,WAAsC,EAAE,uBAA+D;IAClI,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,iBAAiB,CAAC,UAAU,EAAE,uBAAuB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/H,OAAO,WAAW,CAAC,aAAa,EAAE,aAAa,EAAE,gBAAgB,WAAW,CAAC,MAAM,GAAG,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChJ,CAAC;AAED,mIAAmI;AACnI,SAAS,0BAA0B,CAAC,OAAoB;IACtD,MAAM,OAAO,GAAG;QACd,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,kBAAkB,IAAA,8BAAiB,EAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjG,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACvD,CAAC;IACF,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,eAAe,CAAC,OAAoB,EAAE,IAAY,EAAE,WAAmB;IAC9E,MAAM,MAAM,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,IAAA,8BAAiB,EAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,IAAA,2BAAc,EAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,IAAA,8BAAiB,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,WAAW,EAAE,OAAO,UAAU,KAAK,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC1F,MAAM,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC;IACvD,OAAO;QACL,GAAG,EAAE,WAAW,OAAO,CAAC,EAAE,EAAE;QAC5B,IAAI,EAAE,SAAS;QACf,OAAO;QACP,IAAI,EAAE,IAAA,0BAAa,EAAC,IAAI,IAAI,aAAa,CAAC;QAC1C,QAAQ,EAAE,IAAI;QACd,yFAAyF;QACzF,IAAI,EAAE,OAAO,CAAC,GAAG,MAAM,KAAK,IAAI,EAAE,CAAC;QACnC,OAAO,EAAE;YACP,KAAK,EAAE,WAAW,EAAE,OAAO,UAAU,SAAS,OAAO,EAAE;YACvD,QAAQ,EAAE,UAAU,IAAA,8BAAiB,EAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,oBAAoB,OAAO,IAAA,2BAAc,EAAC,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE;YACnJ,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,KAAK,WAAW,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,cAAc,KAAK,WAAW,CAAC;SACrH;KACF,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,SAAS,sBAAsB,CAAC,QAAgC;IAC9D,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AACnG,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,OAAyB,EAAE,WAAsC,EAAE,WAAmB;IACrH,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3H,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;QACpC,GAAG,IAAA,6CAAyB,EAAC,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,WAAW,CAAC;QACvE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,IAAA,6CAAyB,EAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;KACvF,CAAC,CAAC;IACH,MAAM,uBAAuB,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC5D,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,IAAA,uCAAmB,EAAC;QAC5D,WAAW;QACX,qBAAqB;QACrB,UAAU,EAAE,CAAC,aAAa,EAAE,EAAE;YAC5B,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;gBACzC,MAAM,SAAS,GAAG,uBAAuB,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;gBAClE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBAAE,uBAAuB,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,GAAG,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;YACzG,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,IAAA,gBAAU,EAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACvG,MAAM,gBAAgB,GAAG,WAAW,CAAC,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,IAAA,0BAAa,EAAC,eAAe,IAAI,aAAa,CAAC,EAAE,eAAe,CAAC,CAAC;IACpJ,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,IAAA,gBAAU,EAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,WAAW,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;IACvJ,OAAO;QACL,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC;QACpC,gBAAgB;QAChB,iBAAiB,CAAC,OAAO,CAAC;QAC1B,aAAa,CAAC,OAAO,CAAC;QACtB,mBAAmB,CAAC,WAAW,EAAE,uBAAuB,CAAC;QACzD,GAAG,aAAa;KACjB,CAAC;AACJ,CAAC"}

package/dist/connectors/jira/issueContext.d.ts

@@ -0,0 +1,25 @@
+import type { JiraClient, JiraComment, JiraIssue, JiraRemoteLink } from './client';
+/**
+ * @description Everything one request's prompt says about an issue (plan C1,
+ * C2): the issue's own fields, ALL its comments (the issue field holds at most
+ * 100), its remote links, and — for an issue that can hold children, such as an
+ * epic — ALL its children, read page by page. Fetched before the request opens:
+ * a request is never left without its prompt.
+ */
+/** The fields every prompt reads; a project's `extraFields` ids are added to them. */
+export declare const jiraPromptIssueFields: string[];
+export declare const jiraChildSearchPageSize = 100;
+/** An issue type at this level or above holds child issues (an epic); level 0 holds sub-tasks, below 0 is a sub-task. */
+export declare const jiraParentHierarchyLevel = 1;
+export type JiraIssueContextClient = Pick<JiraClient, 'getIssue' | 'getComments' | 'getRemoteLinks' | 'searchIssues'>;
+export interface JiraIssueContext {
+    issue: JiraIssue;
+    /** Oldest first. */
+    comments: JiraComment[];
+    remoteLinks: JiraRemoteLink[];
+    /** The issue's children when its type can hold them, else empty (its sub-tasks are on the issue itself). */
+    children: JiraIssue[];
+}
+/** @description Read the issue, its comments, its remote links and, when it can have them, its children. */
+export declare function fetchJiraIssueContext(client: JiraIssueContextClient, issueKey: string, extraFieldIds: readonly string[]): Promise<JiraIssueContext>;
+//# sourceMappingURL=issueContext.d.ts.map

package/dist/connectors/jira/issueContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issueContext.d.ts","sourceRoot":"","sources":["../../../src/connectors/jira/issueContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEnF;;;;;;GAMG;AAEH,sFAAsF;AACtF,eAAO,MAAM,qBAAqB,UAGjC,CAAC;AAIF,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,yHAAyH;AACzH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,GAAG,gBAAgB,GAAG,cAAc,CAAC,CAAC;AAEtH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,oBAAoB;IACpB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,4GAA4G;IAC5G,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB;AAwBD,4GAA4G;AAC5G,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,sBAAsB,EAC9B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAQ3B"}

package/dist/connectors/jira/issueContext.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jiraParentHierarchyLevel = exports.jiraChildSearchPageSize = exports.jiraPromptIssueFields = void 0;
+exports.fetchJiraIssueContext = fetchJiraIssueContext;
+/**
+ * @description Everything one request's prompt says about an issue (plan C1,
+ * C2): the issue's own fields, ALL its comments (the issue field holds at most
+ * 100), its remote links, and — for an issue that can hold children, such as an
+ * epic — ALL its children, read page by page. Fetched before the request opens:
+ * a request is never left without its prompt.
+ */
+/** The fields every prompt reads; a project's `extraFields` ids are added to them. */
+exports.jiraPromptIssueFields = [
+    'summary', 'status', 'issuetype', 'priority', 'parent', 'subtasks', 'issuelinks', 'fixVersions', 'labels',
+    'components', 'attachment', 'description', 'reporter',
+];
+/** Only the description's HTML is asked for: it names the attachment behind an inline file (C9). */
+const renderedFieldsExpand = 'renderedFields';
+const childIssueFields = ['summary', 'status', 'issuetype'];
+exports.jiraChildSearchPageSize = 100;
+/** An issue type at this level or above holds child issues (an epic); level 0 holds sub-tasks, below 0 is a sub-task. */
+exports.jiraParentHierarchyLevel = 1;
+/** A JQL string literal: the key is Jira's own, but a quote or backslash in it must never end the literal. */
+function getJqlQuoted(text) {
+    return `"${text.replace(/["\\]/g, '\\$&')}"`;
+}
+async function getChildIssues(client, issueKey) {
+    const children = [];
+    let nextPageToken;
+    do {
+        const page = await client.searchIssues({
+            jql: `parent = ${getJqlQuoted(issueKey)} ORDER BY created ASC`,
+            fields: childIssueFields,
+            isChangelogExpanded: false,
+            maxResults: exports.jiraChildSearchPageSize,
+            nextPageToken,
+        });
+        children.push(...page.issues);
+        nextPageToken = page.isLast ? undefined : (page.nextPageToken ?? undefined);
+    } while (nextPageToken);
+    return children;
+}
+/** @description Read the issue, its comments, its remote links and, when it can have them, its children. */
+async function fetchJiraIssueContext(client, issueKey, extraFieldIds) {
+    const [issue, comments, remoteLinks] = await Promise.all([
+        client.getIssue(issueKey, [...exports.jiraPromptIssueFields, ...extraFieldIds], renderedFieldsExpand),
+        client.getComments(issueKey),
+        client.getRemoteLinks(issueKey),
+    ]);
+    const isParent = (issue.fields.issuetype?.hierarchyLevel ?? 0) >= exports.jiraParentHierarchyLevel;
+    return { issue, comments, remoteLinks, children: isParent ? await getChildIssues(client, issueKey) : [] };
+}
+//# sourceMappingURL=issueContext.js.map

package/dist/connectors/jira/issueContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issueContext.js","sourceRoot":"","sources":["../../../src/connectors/jira/issueContext.ts"],"names":[],"mappings":";;;AAwDA,sDAYC;AAlED;;;;;;GAMG;AAEH,sFAAsF;AACzE,QAAA,qBAAqB,GAAG;IACnC,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ;IACzG,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU;CACtD,CAAC;AACF,oGAAoG;AACpG,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAC9C,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC/C,QAAA,uBAAuB,GAAG,GAAG,CAAC;AAC3C,yHAAyH;AAC5G,QAAA,wBAAwB,GAAG,CAAC,CAAC;AAa1C,8GAA8G;AAC9G,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;AAC/C,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,MAA8B,EAAE,QAAgB;IAC5E,MAAM,QAAQ,GAAgB,EAAE,CAAC;IACjC,IAAI,aAAiC,CAAC;IACtC,GAAG,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;YACrC,GAAG,EAAE,YAAY,YAAY,CAAC,QAAQ,CAAC,uBAAuB;YAC9D,MAAM,EAAE,gBAAgB;YACxB,mBAAmB,EAAE,KAAK;YAC1B,UAAU,EAAE,+BAAuB;YACnC,aAAa;SACd,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,IAAI,SAAS,CAAC,CAAC;IAC9E,CAAC,QAAQ,aAAa,EAAE;IACxB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,4GAA4G;AACrG,KAAK,UAAU,qBAAqB,CACzC,MAA8B,EAC9B,QAAgB,EAChB,aAAgC;IAEhC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvD,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,6BAAqB,EAAE,GAAG,aAAa,CAAC,EAAE,oBAAoB,CAAC;QAC7F,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC;QAC5B,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC;KAChC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,IAAI,CAAC,CAAC,IAAI,gCAAwB,CAAC;IAC3F,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC5G,CAAC"}

package/dist/connectors/jira/issueDelta.d.ts

@@ -0,0 +1,35 @@
+import type { JiraSentBlocks } from './contextLedger';
+import type { IssueBlock, IssueBlockKind } from './issueBlocks';
+/**
+ * @description What a prompt to a conversation that already knows the issue
+ * carries (prompt context C3, C7): only the blocks it has not seen.
+ *
+ *   key not sent before             → `new`
+ *   sent, hash differs              → comment: `edited <date> by <name>`, other: `changed since your last prompt`
+ *   sent, same hash                 → left out, counted in the "unchanged" line
+ *   the AI account's own comment    → left out (it wrote it), unless a person edited it
+ *   a sent comment that is gone     → one "was deleted" line, then forgotten
+ *
+ * Every current block goes into the sent-set the prompt makes once taken in,
+ * the ones left out included; a deleted comment does not.
+ */
+export declare const newBlockNote = "new";
+export declare const changedBlockNote = "changed since your last prompt";
+export interface IssueDeltaEntry {
+    block: IssueBlock;
+    stateNote: string;
+}
+export interface IssueDelta {
+    /** The blocks to print, in prompt order, each with its note. */
+    entries: IssueDeltaEntry[];
+    /** The kinds of the non-comment blocks left out, in prompt order. */
+    unchangedKinds: IssueBlockKind[];
+    unchangedCommentCount: number;
+    /** `comment <id> by <name> from <date>` of each comment sent before and gone now. */
+    deletedCommentLabels: string[];
+    /** The sent-set once this prompt is taken in. */
+    sent: JiraSentBlocks;
+}
+/** @description The delta of `blocks` against `sent`; an empty `sent` makes every block new. */
+export declare function getIssueDelta(blocks: readonly IssueBlock[], sent: Readonly<JiraSentBlocks>): IssueDelta;
+//# sourceMappingURL=issueDelta.d.ts.map

package/dist/connectors/jira/issueDelta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issueDelta.d.ts","sourceRoot":"","sources":["../../../src/connectors/jira/issueDelta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEhE;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,YAAY,QAAQ,CAAC;AAClC,eAAO,MAAM,gBAAgB,mCAAmC,CAAC;AAGjE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,gEAAgE;IAChE,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,qEAAqE;IACrE,cAAc,EAAE,cAAc,EAAE,CAAC;IACjC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qFAAqF;IACrF,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,iDAAiD;IACjD,IAAI,EAAE,cAAc,CAAC;CACtB;AASD,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,UAAU,CAcvG"}

package/dist/connectors/jira/issueDelta.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.changedBlockNote = exports.newBlockNote = void 0;
+exports.getIssueDelta = getIssueDelta;
+/**
+ * @description What a prompt to a conversation that already knows the issue
+ * carries (prompt context C3, C7): only the blocks it has not seen.
+ *
+ *   key not sent before             → `new`
+ *   sent, hash differs              → comment: `edited <date> by <name>`, other: `changed since your last prompt`
+ *   sent, same hash                 → left out, counted in the "unchanged" line
+ *   the AI account's own comment    → left out (it wrote it), unless a person edited it
+ *   a sent comment that is gone     → one "was deleted" line, then forgotten
+ *
+ * Every current block goes into the sent-set the prompt makes once taken in,
+ * the ones left out included; a deleted comment does not.
+ */
+exports.newBlockNote = 'new';
+exports.changedBlockNote = 'changed since your last prompt';
+const commentKeyPrefix = 'comment:';
+function getStateNote(block, sentHash) {
+    if (block.comment?.isOwn)
+        return null;
+    if (sentHash === undefined)
+        return exports.newBlockNote;
+    if (sentHash === block.hash)
+        return null;
+    return block.comment ? block.comment.editNote : exports.changedBlockNote;
+}
+/** @description The delta of `blocks` against `sent`; an empty `sent` makes every block new. */
+function getIssueDelta(blocks, sent) {
+    const delta = { entries: [], unchangedKinds: [], unchangedCommentCount: 0, deletedCommentLabels: [], sent: {} };
+    for (const block of blocks) {
+        delta.sent[block.key] = block.comment ? { hash: block.hash, label: block.comment.label } : { hash: block.hash };
+        const stateNote = getStateNote(block, sent[block.key]?.hash);
+        if (stateNote !== null)
+            delta.entries.push({ block, stateNote });
+        else if (block.kind === 'comment')
+            delta.unchangedCommentCount += 1;
+        else
+            delta.unchangedKinds.push(block.kind);
+    }
+    const currentKeys = new Set(blocks.map((block) => block.key));
+    for (const [key, sentBlock] of Object.entries(sent)) {
+        if (key.startsWith(commentKeyPrefix) && !currentKeys.has(key))
+            delta.deletedCommentLabels.push(sentBlock.label ?? key);
+    }
+    return delta;
+}
+//# sourceMappingURL=issueDelta.js.map

package/dist/connectors/jira/issueDelta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issueDelta.js","sourceRoot":"","sources":["../../../src/connectors/jira/issueDelta.ts"],"names":[],"mappings":";;;AA8CA,sCAcC;AAzDD;;;;;;;;;;;;GAYG;AAEU,QAAA,YAAY,GAAG,KAAK,CAAC;AACrB,QAAA,gBAAgB,GAAG,gCAAgC,CAAC;AACjE,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAmBpC,SAAS,YAAY,CAAC,KAAiB,EAAE,QAA4B;IACnE,IAAI,KAAK,CAAC,OAAO,EAAE,KAAK;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,oBAAY,CAAC;IAChD,IAAI,QAAQ,KAAK,KAAK,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,wBAAgB,CAAC;AACnE,CAAC;AAED,gGAAgG;AAChG,SAAgB,aAAa,CAAC,MAA6B,EAAE,IAA8B;IACzF,MAAM,KAAK,GAAe,EAAE,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,qBAAqB,EAAE,CAAC,EAAE,oBAAoB,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC5H,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QAChH,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QAC7D,IAAI,SAAS,KAAK,IAAI;YAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;aAC5D,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,qBAAqB,IAAI,CAAC,CAAC;;YAC/D,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,IAAI,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC;IACzH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/connectors/jira/mediaPlaceholders.d.ts

@@ -0,0 +1,20 @@
+import { type AdfMediaResolver } from './adf';
+import type { JiraAttachment } from './client';
+/**
+ * @description The media id → attachment id pairs a rendered body (a comment's
+ * `renderedBody`, an issue's `renderedFields.description`) states: every `<a>`
+ * that carries a `data-media-services-id` and a `/attachment/content/<id>` link.
+ * Only those two attributes are read; the HTML itself never reaches the prompt.
+ */
+export declare function getAttachmentIdsByMediaId(renderedHtml: string | null | undefined): Map<string, string>;
+export interface MediaResolverContext {
+    /** The issue's `attachment` list. */
+    attachments: readonly JiraAttachment[];
+    /** Media id → attachment id, merged from the rendered description and comments. */
+    attachmentIdByMediaId: ReadonlyMap<string, string>;
+    /** Told, for each media node resolved, which attachments it stands for — the attachments block's "referenced in". */
+    onResolved?: (attachmentIds: readonly string[]) => void;
+}
+/** @description The resolver `getAdfText` takes for one issue's text. Pure apart from `onResolved`. */
+export declare function createMediaResolver(context: MediaResolverContext): AdfMediaResolver;
+//# sourceMappingURL=mediaPlaceholders.d.ts.map

package/dist/connectors/jira/mediaPlaceholders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaPlaceholders.d.ts","sourceRoot":"","sources":["../../../src/connectors/jira/mediaPlaceholders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,gBAAgB,EAAgB,MAAM,OAAO,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AA6B/C;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAUtG;AAED,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;IACvC,mFAAmF;IACnF,qBAAqB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,qHAAqH;IACrH,UAAU,CAAC,EAAE,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;CACzD;AA0BD,uGAAuG;AACvG,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,gBAAgB,CAanF"}

package/dist/connectors/jira/mediaPlaceholders.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAttachmentIdsByMediaId = getAttachmentIdsByMediaId;
+exports.createMediaResolver = createMediaResolver;
+const adf_1 = require("./adf");
+const promptText_1 = require("./promptText");
+/**
+ * @description How a media node in an issue's text reaches the agent (plan C9):
+ * as a placeholder where the file sat, naming the attachment to fetch —
+ * `[image: login-error.png — attachment 10234]`. A pasted screenshot or video
+ * is a `media` node whose id is a Media Services id, NOT the attachment id, so
+ * the attachment is found from what Jira records (real ADF, S1 fixture):
+ *
+ *  1. an upload whose name was already taken is stored as `<stem> (<media id>).<ext>`:
+ *     the attachment whose filename CONTAINS the media id — exact;
+ *  2. otherwise every attachment named exactly like the node's `alt` (the original
+ *     file name) — all their ids are listed, because a REST upload keeps duplicate names;
+ *  3. an inline file (`mediaInline`) has no `alt` at all, but the rendered HTML
+ *     links it to its attachment together with the media id
+ *     (`<a href=".../attachment/content/<id>" data-media-services-id="<media id>">`):
+ *     {@link getAttachmentIdsByMediaId} reads that — exact, so nothing is guessed;
+ *  4. nothing found → `attachment unknown`.
+ */
+const attachmentContentPathRe = /\/attachment\/content\/(\d+)/;
+const htmlAnchorTagRe = /<a\b[^>]*>/gi;
+const htmlAttributeRe = /([A-Za-z_][-A-Za-z0-9_:.]*)\s*=\s*"([^"]*)"/g;
+const mediaServicesIdAttribute = 'data-media-services-id';
+const unknownAttachmentText = 'attachment unknown';
+const inlineFileLabel = 'inline file';
+const externalMediaType = 'external';
+/**
+ * @description The media id → attachment id pairs a rendered body (a comment's
+ * `renderedBody`, an issue's `renderedFields.description`) states: every `<a>`
+ * that carries a `data-media-services-id` and a `/attachment/content/<id>` link.
+ * Only those two attributes are read; the HTML itself never reaches the prompt.
+ */
+function getAttachmentIdsByMediaId(renderedHtml) {
+    const attachmentIdByMediaId = new Map();
+    for (const [anchorTag] of (renderedHtml ?? '').matchAll(htmlAnchorTagRe)) {
+        const attributes = new Map();
+        for (const [, name, value] of anchorTag.matchAll(htmlAttributeRe))
+            attributes.set(name.toLowerCase(), value);
+        const mediaId = attributes.get(mediaServicesIdAttribute);
+        const attachmentId = attachmentContentPathRe.exec(attributes.get('href') ?? '')?.[1];
+        if (mediaId && attachmentId)
+            attachmentIdByMediaId.set(mediaId, attachmentId);
+    }
+    return attachmentIdByMediaId;
+}
+/** What kind of file the placeholder names, from its type: only an image or a video is worth saying. */
+function getMediaKind(mimeType) {
+    if (mimeType?.startsWith('image/'))
+        return 'image';
+    if (mimeType?.startsWith('video/'))
+        return 'video';
+    return 'file';
+}
+function getAttachmentTarget(attachmentIds) {
+    if (attachmentIds.length === 0)
+        return unknownAttachmentText;
+    return attachmentIds.length === 1 ? `attachment ${attachmentIds[0]}` : `attachments ${attachmentIds.join(', ')}`;
+}
+/** The ids of the attachments a `file` media node stands for (rules 1–3 above); empty when none is found. */
+function getAttachmentIds(node, context) {
+    const mediaId = (0, adf_1.getStringAttribute)(node, 'id') ?? '';
+    const alt = (0, adf_1.getStringAttribute)(node, 'alt') ?? '';
+    const fromRenderedHtml = mediaId ? context.attachmentIdByMediaId.get(mediaId) : undefined;
+    if (fromRenderedHtml)
+        return [fromRenderedHtml];
+    // An empty id would match every filename.
+    const byMediaId = mediaId ? context.attachments.filter((attachment) => attachment.filename.includes(mediaId)) : [];
+    if (byMediaId.length > 0)
+        return byMediaId.map((attachment) => attachment.id);
+    return alt ? context.attachments.filter((attachment) => attachment.filename === alt).map((attachment) => attachment.id) : [];
+}
+/** @description The resolver `getAdfText` takes for one issue's text. Pure apart from `onResolved`. */
+function createMediaResolver(context) {
+    return (node) => {
+        if (node.type === 'media' && (0, adf_1.getStringAttribute)(node, 'type') === externalMediaType) {
+            return `[image: ${(0, promptText_1.getSingleLineText)((0, adf_1.getStringAttribute)(node, 'url') ?? '')}]`;
+        }
+        const attachmentIds = getAttachmentIds(node, context);
+        context.onResolved?.(attachmentIds);
+        const firstAttachment = context.attachments.find((attachment) => attachment.id === attachmentIds[0]);
+        const name = (0, promptText_1.getSingleLineText)((0, adf_1.getStringAttribute)(node, 'alt') ?? firstAttachment?.filename ?? '');
+        const target = getAttachmentTarget(attachmentIds);
+        if (!name)
+            return `[${inlineFileLabel} — ${target}]`;
+        return `[${getMediaKind(firstAttachment?.mimeType)}: ${name} — ${target}]`;
+    };
+}
+//# sourceMappingURL=mediaPlaceholders.js.map

package/dist/connectors/jira/mediaPlaceholders.js.map

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

package/dist/connectors/jira/outbound.d.ts

@@ -0,0 +1,6 @@
+import type { ConnectorCapabilities, ConnectorOutbound } from '../../platform/outbound';
+export declare const jiraCapabilities: ConnectorCapabilities;
+/** The error a file-send to a Jira issue answers with. */
+export declare const jiraFileSendRefusal = "Files cannot be sent to a Jira issue; describe the result in your answer instead.";
+export declare function createJiraConnectorOutbound(): ConnectorOutbound;
+//# sourceMappingURL=outbound.d.ts.map

package/dist/connectors/jira/outbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound.d.ts","sourceRoot":"","sources":["../../../src/connectors/jira/outbound.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAaxF,eAAO,MAAM,gBAAgB,EAAE,qBAS9B,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,sFAAsF,CAAC;AAEvH,wBAAgB,2BAA2B,IAAI,iBAAiB,CAW/D"}

package/dist/connectors/jira/outbound.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jiraFileSendRefusal = exports.jiraCapabilities = void 0;
+exports.createJiraConnectorOutbound = createJiraConnectorOutbound;
+/**
+ * @description Jira's outbound (Jira connector plan J2, D19). A Jira issue gets
+ * the agent's ANSWERS only — they go through the Jira answer sink as comments —
+ * never its streamed output, so this outbound drops stream content and activity:
+ * a comment per output chunk would bury the issue. Files are refused with a
+ * reason the agent can read.
+ */
+/** Jira rejects a comment body longer than this. */
+const jiraCommentMaxChars = 32_767;
+exports.jiraCapabilities = {
+    editMessages: false,
+    pinMessages: false,
+    tappableOptions: false,
+    attachments: false,
+    threadedReplies: false,
+    activityIndicator: false,
+    maxMessageChars: jiraCommentMaxChars,
+    markupDialect: 'markdown',
+};
+/** The error a file-send to a Jira issue answers with. */
+exports.jiraFileSendRefusal = 'Files cannot be sent to a Jira issue; describe the result in your answer instead.';
+function createJiraConnectorOutbound() {
+    return {
+        capabilities: exports.jiraCapabilities,
+        deliver: async () => { },
+        deliverFile: async () => ({ ok: false, error: exports.jiraFileSendRefusal }),
+        setActivity: () => { },
+        finalize: async () => { },
+        dispose: () => { },
+        checkIsDelivering: () => false,
+        listUnfinalizedKeys: () => [],
+    };
+}
+//# sourceMappingURL=outbound.js.map

package/dist/connectors/jira/outbound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound.js","sourceRoot":"","sources":["../../../src/connectors/jira/outbound.ts"],"names":[],"mappings":";;;AA2BA,kEAWC;AApCD;;;;;;GAMG;AAEH,oDAAoD;AACpD,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEtB,QAAA,gBAAgB,GAA0B;IACrD,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,KAAK;IAClB,eAAe,EAAE,KAAK;IACtB,WAAW,EAAE,KAAK;IAClB,eAAe,EAAE,KAAK;IACtB,iBAAiB,EAAE,KAAK;IACxB,eAAe,EAAE,mBAAmB;IACpC,aAAa,EAAE,UAAU;CAC1B,CAAC;AAEF,0DAA0D;AAC7C,QAAA,mBAAmB,GAAG,mFAAmF,CAAC;AAEvH,SAAgB,2BAA2B;IACzC,OAAO;QACL,YAAY,EAAE,wBAAgB;QAC9B,OAAO,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACvB,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,2BAAmB,EAAE,CAAC;QACpE,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;QACrB,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACxB,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;QACjB,iBAAiB,EAAE,GAAG,EAAE,CAAC,KAAK;QAC9B,mBAAmB,EAAE,GAAG,EAAE,CAAC,EAAE;KAC9B,CAAC;AACJ,CAAC"}

package/dist/connectors/jira/prompt.d.ts

@@ -0,0 +1,37 @@
+import type { JiraAccount } from './client';
+import { type IssueBlock } from './issueBlocks';
+import { type CommentsFile } from './promptSpill';
+import type { IssueDelta } from './issueDelta';
+import type { JiraIssueTrigger } from './trigger';
+/** How the issue reached the agent, in a few words — the header's `from:`. */
+export declare function getJiraOriginDescription(issueKey: string, trigger: JiraIssueTrigger, statusName: string | undefined): string;
+/** What every prompt of a request says before the issue itself: who, which issue, where answers go. */
+export interface JiraRequestPromptBase {
+    requestId: string;
+    issueKey: string;
+    /** The issue's status, for the header's `from:` of a status-triggered request. */
+    statusName: string | undefined;
+    /** `https://<site>/browse/<KEY>`. */
+    issueUrl: string;
+    trigger: JiraIssueTrigger;
+    requester: JiraAccount | null;
+    /** The same requester's earlier requests of the issue this one replaced (R34); the header names them. */
+    supersededRequestIds?: readonly string[];
+}
+export interface JiraRequestPromptInput extends JiraRequestPromptBase {
+    /** The issue as its blocks, in prompt order (`buildIssueBlocks`, fitted by `fitBlocksToPrompt`). */
+    blocks: readonly IssueBlock[];
+    /** Set when the comments went to one file because even their stubs did not fit: it stands for the comment blocks. */
+    commentsFile?: CommentsFile | null;
+}
+/** @description The whole issue: the prompt of a conversation that does not know the issue yet (or no longer does). */
+export declare function buildJiraRequestPrompt(input: JiraRequestPromptInput): string;
+/**
+ * @description Only what changed since the conversation's last prompt (C3, C7):
+ * the new and changed blocks with their note, one line per deleted comment, and
+ * one line naming what was left out, so the agent knows nothing was dropped.
+ */
+export declare function buildJiraDeltaPrompt(input: JiraRequestPromptBase & {
+    delta: IssueDelta;
+}): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/connectors/jira/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/connectors/jira/prompt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AA0BlD,8EAA8E;AAC9E,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAU5H;AAED,uGAAuG;AACvG,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,yGAAyG;IACzG,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB;IACnE,oGAAoG;IACpG,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IAC9B,qHAAqH;IACrH,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACpC;AAmBD,uHAAuH;AACvH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAa5E;AAQD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,qBAAqB,GAAG;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,MAAM,CAWjG"}