charness 0.0.0-stage → 3.0.0

package/dist/connectors/jira/config.js

@@ -0,0 +1,350 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claudeMemoryMarkerNames = exports.jiraDefaultEffort = exports.jiraDefaultModel = exports.jiraRunBudgetDefault = exports.jiraPollIntervalDefaultSeconds = exports.jiraPollIntervalMaxSeconds = exports.jiraPollIntervalMinSeconds = void 0;
+exports.getClaudeMemoryAbove = getClaudeMemoryAbove;
+exports.getOpenCodeIsolationError = getOpenCodeIsolationError;
+exports.validateJiraConfig = validateJiraConfig;
+exports.loadJiraConfig = loadJiraConfig;
+exports.resolveTriggerStatusIds = resolveTriggerStatusIds;
+exports.resolveExtraFields = resolveExtraFields;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const mcpConfig_1 = require("../../mcpConfig");
+const validation_1 = require("../../validation");
+const installManager_1 = require("../../installManager");
+const adapterNames_1 = require("../../adapters/adapterNames");
+const effortLevels_1 = require("../../effortLevels");
+const sessionKeyCodec_1 = require("./sessionKeyCodec");
+const configFile_1 = require("./configFile");
+/**
+ * @description The Jira connector's configuration (Jira connector plan J4,
+ * D10/D11/D16, R4/R9; J4b R12/R14/R15): `DATA_DIR/jira.json`, `${VAR}` placeholders expanded from
+ * the environment (the secrets stay in the instance's env file, never in the
+ * JSON). Validation names the field that is wrong and never echoes a value.
+ */
+/** Poll interval bounds and default, seconds (D13). */
+exports.jiraPollIntervalMinSeconds = 10;
+exports.jiraPollIntervalMaxSeconds = 600;
+exports.jiraPollIntervalDefaultSeconds = 90;
+/** Requests per issue per rolling 24 h (D12). */
+exports.jiraRunBudgetDefault = 5;
+/** What a Jira session runs on when `jira.json` names neither (C14); either key still overrides its own default. */
+exports.jiraDefaultModel = 'opus';
+exports.jiraDefaultEffort = 'high';
+/** The backend a Jira session runs on by default (D16, R14); `claude-per-turn` is the other allowed one (L-D12). */
+const jiraAdapterName = adapterNames_1.claudeJsonStreamAdapterName;
+/** Backends refused for a Jira project, each with its reason. */
+const refusedAdapterReasons = new Map([
+    ['opencode', 'OpenCode is not available for a Jira project (it cannot be isolated yet)'],
+    ['claude', 'the tmux Claude backend is not available for a Jira project (its folder-trust dialog would hold the session)'],
+]);
+/**
+ * What Claude Code loads as project memory from the working folder AND every
+ * folder above it (R12): any of these above a Jira folder brings someone's
+ * instructions into the session — under HOME that is the operator's own setup.
+ */
+exports.claudeMemoryMarkerNames = ['CLAUDE.md', 'CLAUDE.local.md', 'AGENTS.md', '.claude'];
+/** A model name as `claude --model` takes it (`opus`, `claude-opus-5-5`, `opus[1m]`). */
+const claudeModelRe = /^[A-Za-z0-9][A-Za-z0-9._:/[\]-]*$/;
+const claudeModelMaxLength = 100;
+/** A Jira Cloud site: a bare `<name>.atlassian.net` host — no scheme, port or path. */
+const atlassianSiteRe = /^[a-z0-9][a-z0-9-]*\.atlassian\.net$/;
+const unexpandedPlaceholderRe = /\$\{([A-Z_][A-Z0-9_]*)\}/;
+/** Fixed wording per bind failure: `BindError` messages embed the folder, a value. */
+const folderErrorTexts = {
+    BIND_INVALID_CHARS: 'is empty or holds control characters',
+    BIND_NOT_FOUND: 'does not exist under WORK_ROOT',
+    BIND_OUTSIDE_ROOT: 'is outside WORK_ROOT',
+    BIND_NOT_DIRECTORY: 'is not a directory',
+};
+/** A tool's name on the agent's PATH: ONE file name (never `.` or `..`, never a path). */
+const agentBinaryNameRe = /^(?!\.{1,2}$)[A-Za-z0-9._-]+$/;
+/** Hosts the test-only `baseUrl` override may point at. */
+const loopbackHosts = new Set(['127.0.0.1', 'localhost', '[::1]']);
+// Strict: a misspelled key (`adaptor`, `pollIntervalSecond`) is an error, never a silently applied default.
+const projectSchema = zod_1.z.strictObject({
+    folder: zod_1.z.string().min(1),
+    triggerStatuses: zod_1.z.array(zod_1.z.string().min(1)).min(1),
+    // Fields beyond the standard ones the prompt shows, by id (`customfield_10042`, `duedate`); none by default (C11).
+    // Whether the site has the field is checked at boot against its field list, never refused here.
+    extraFields: zod_1.z.array(zod_1.z.string().min(1)).optional(),
+});
+const rawConfigSchema = zod_1.z.strictObject({
+    site: zod_1.z.string().min(1),
+    email: zod_1.z.string().min(1),
+    apiToken: zod_1.z.string().min(1),
+    accountId: zod_1.z.string().min(1),
+    projects: zod_1.z.record(zod_1.z.string(), projectSchema),
+    pollIntervalSeconds: zod_1.z.number().int().min(exports.jiraPollIntervalMinSeconds).max(exports.jiraPollIntervalMaxSeconds).optional(),
+    runBudgetPer24h: zod_1.z.number().int().min(1).optional(),
+    adapter: zod_1.z.string().min(1).optional(),
+    // R15: user settings no longer apply in a Jira session, so its model and effort come from here.
+    model: zod_1.z.string().max(claudeModelMaxLength).regex(claudeModelRe, 'must be a model name like opus or claude-opus-5-5').optional(),
+    effort: zod_1.z.enum(effortLevels_1.claudeEffortLevels).optional(),
+    baseUrl: zod_1.z.string().min(1).optional(),
+    // C11: tools the agent should find on its PATH (`ffmpeg`): name → absolute path of the program.
+    agentBinaries: zod_1.z.record(zod_1.z.string().regex(agentBinaryNameRe, 'must be one file name'), zod_1.z.string().min(1)).optional(),
+});
+/** Why `binaryPath` cannot serve as a tool, or `null`: it must be an absolute path to an executable regular file. */
+function getAgentBinaryError(binaryPath) {
+    if (!path.isAbsolute(binaryPath))
+        return 'must be an absolute path';
+    try {
+        if (!fs.statSync(binaryPath).isFile())
+            return 'is not a file';
+        fs.accessSync(binaryPath, fs.constants.X_OK);
+    }
+    catch (e) {
+        return e instanceof Error && 'code' in e && e.code === 'ENOENT' ? 'does not exist' : 'is not executable';
+    }
+    return null;
+}
+/**
+ * @description R12: the marker of Claude memory nearest a folder — in the folder
+ * itself or any folder above it, up to the filesystem root — with how many
+ * levels up it was found; `null` when the ancestry is clean.
+ */
+function getClaudeMemoryAbove(folderPath) {
+    let current = path.resolve(folderPath);
+    for (let levelsUp = 0;; levelsUp += 1) {
+        const markerName = exports.claudeMemoryMarkerNames.find((name) => fs.existsSync(path.join(current, name)));
+        if (markerName)
+            return { markerName, levelsUp };
+        const parent = path.dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+/** Names of the fields that still hold a `${VAR}` placeholder — a variable the env file does not set. */
+function getUnexpandedFields(node, pathPrefix) {
+    const fields = [];
+    for (const [name, value] of Object.entries(node)) {
+        const fieldPath = pathPrefix ? `${pathPrefix}.${name}` : name;
+        if (typeof value === 'string') {
+            const match = unexpandedPlaceholderRe.exec(value);
+            if (match)
+                fields.push(`${fieldPath} (\${${match[1]}} is not set)`);
+        }
+        else if (value !== null && typeof value === 'object') {
+            fields.push(...getUnexpandedFields(value, fieldPath));
+        }
+    }
+    return fields;
+}
+/** The test-only override: http(s) on a loopback host, else an error. */
+function getBaseUrlError(baseUrl) {
+    let url;
+    try {
+        url = new URL(baseUrl);
+    }
+    catch {
+        return 'baseUrl is not a URL';
+    }
+    if ((url.protocol !== 'http:' && url.protocol !== 'https:') || !loopbackHosts.has(url.hostname)) {
+        return 'baseUrl is a test-only override and must point at a loopback host';
+    }
+    return null;
+}
+/**
+ * @description R9: a Jira instance must not share the default OpenCode server —
+ * every other instance on the host (another bot's included) uses it by default,
+ * and an OpenCode start may stop a stale server it finds on that port.
+ */
+function getOpenCodeIsolationError(openCodeUrl) {
+    let port;
+    try {
+        port = (0, installManager_1.getOpenCodePort)(new URL(openCodeUrl || installManager_1.defaultOpenCodeUrl));
+    }
+    catch {
+        return 'OPENCODE_URL is not a URL';
+    }
+    if (port === (0, installManager_1.getOpenCodePort)(new URL(installManager_1.defaultOpenCodeUrl))) {
+        return `OPENCODE_URL must name a port of its own, not the default ${installManager_1.defaultOpenCodeUrl} other instances use`;
+    }
+    return null;
+}
+/**
+ * @description Validate an already-parsed `jira.json` object against the rules
+ * of plan J4. `workRoot` resolves each project's folder; `openCodeUrl` is the
+ * instance's `OPENCODE_URL`.
+ */
+function validateJiraConfig(parsedJson, context) {
+    const expanded = (0, mcpConfig_1.expandEnvVars)(parsedJson);
+    const errors = getUnexpandedFields(expanded, '').map((field) => `jira.json ${field}`);
+    const parsed = rawConfigSchema.safeParse(expanded);
+    if (!parsed.success) {
+        for (const issue of parsed.error.issues) {
+            errors.push(`jira.json ${issue.path.join('.') || '(root)'}: ${issue.message}`);
+        }
+        return { ok: false, errors };
+    }
+    const raw = parsed.data;
+    if (!atlassianSiteRe.test(raw.site))
+        errors.push('jira.json site must be a bare <name>.atlassian.net host');
+    if (raw.baseUrl !== undefined) {
+        const baseUrlError = getBaseUrlError(raw.baseUrl);
+        if (baseUrlError)
+            errors.push(`jira.json ${baseUrlError}`);
+    }
+    const adapterName = raw.adapter ?? jiraAdapterName;
+    const refusedReason = refusedAdapterReasons.get(adapterName);
+    if (refusedReason) {
+        errors.push(`jira.json adapter: ${refusedReason}`);
+    }
+    else if (!(0, adapterNames_1.checkIsJsonStreamBackend)(adapterName)) {
+        errors.push(`jira.json adapter must be ${jiraAdapterName} or ${adapterNames_1.claudePerTurnAdapterName}`);
+    }
+    const openCodeError = getOpenCodeIsolationError(context.openCodeUrl);
+    if (openCodeError)
+        errors.push(openCodeError);
+    const agentBinaries = new Map();
+    for (const [name, binaryPath] of Object.entries(raw.agentBinaries ?? {})) {
+        const binaryError = getAgentBinaryError(binaryPath);
+        if (binaryError)
+            errors.push(`jira.json agentBinaries.${name}: ${binaryError}`);
+        else
+            agentBinaries.set(name, binaryPath);
+    }
+    const projects = new Map();
+    const projectEntries = Object.entries(raw.projects);
+    if (projectEntries.length === 0)
+        errors.push('jira.json projects names no project');
+    for (const [projectKey, project] of projectEntries) {
+        if (!(0, sessionKeyCodec_1.checkIsJiraProjectKey)(projectKey)) {
+            errors.push(`jira.json projects.${projectKey}: not a Jira project key`);
+            continue;
+        }
+        let folder;
+        try {
+            folder = (0, validation_1.validateSubdir)(context.workRoot, project.folder);
+        }
+        catch (e) {
+            const reason = e instanceof validation_1.BindError ? folderErrorTexts[e.code] : 'cannot be resolved';
+            errors.push(`jira.json projects.${projectKey}.folder: ${reason}`);
+            continue;
+        }
+        const memory = getClaudeMemoryAbove(path.join(fs.realpathSync(context.workRoot), folder));
+        if (memory) {
+            const where = memory.levelsUp === 0 ? 'in it' : `${memory.levelsUp} folder(s) above it`;
+            errors.push(`jira.json projects.${projectKey}.folder: Claude would load ${memory.markerName} found ${where} — pick a folder outside HOME and any repository`);
+            continue;
+        }
+        projects.set(projectKey, { folder, triggerStatusNames: project.triggerStatuses, extraFieldIds: [...new Set(project.extraFields ?? [])] });
+    }
+    if (errors.length > 0)
+        return { ok: false, errors };
+    return {
+        ok: true,
+        config: {
+            site: raw.site,
+            baseUrl: raw.baseUrl ?? `https://${raw.site}`,
+            email: raw.email,
+            apiToken: raw.apiToken,
+            accountId: raw.accountId,
+            projects,
+            pollIntervalMs: (raw.pollIntervalSeconds ?? exports.jiraPollIntervalDefaultSeconds) * 1000,
+            runBudgetPer24h: raw.runBudgetPer24h ?? exports.jiraRunBudgetDefault,
+            adapter: adapterName === adapterNames_1.claudePerTurnAdapterName ? adapterNames_1.claudePerTurnAdapterName : jiraAdapterName,
+            model: raw.model ?? exports.jiraDefaultModel,
+            effort: raw.effort ?? exports.jiraDefaultEffort,
+            agentBinaries,
+        },
+    };
+}
+/** @description Read and validate `DATA_DIR/jira.json`. */
+function loadJiraConfig(context) {
+    const configPath = (0, configFile_1.getJiraConfigPath)(context.dataDir);
+    let text;
+    try {
+        text = fs.readFileSync(configPath, 'utf8');
+    }
+    catch {
+        return { ok: false, errors: [`cannot read ${configPath}`] };
+    }
+    let parsedJson;
+    try {
+        const value = JSON.parse(text);
+        if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+            return { ok: false, errors: [`${configPath} must hold a JSON object`] };
+        }
+        parsedJson = value;
+    }
+    catch {
+        return { ok: false, errors: [`${configPath} is not valid JSON`] };
+    }
+    return validateJiraConfig(parsedJson, context);
+}
+/**
+ * @description Resolve a project's trigger status NAMES to the ids changelog
+ * items carry (D11): matched case-insensitively against every status the
+ * project's workflows list. A name the project does not have is an error, so a
+ * typo never silently disables the trigger; a name several statuses share
+ * (one per issue type's workflow) yields all their ids.
+ */
+function resolveTriggerStatusIds(projectKey, statusNames, projectStatuses) {
+    const idsByName = new Map();
+    for (const status of projectStatuses) {
+        const name = status.name.toLowerCase();
+        idsByName.set(name, [...(idsByName.get(name) ?? []), status.id]);
+    }
+    const missing = statusNames.filter((name) => !idsByName.has(name.toLowerCase()));
+    if (missing.length > 0) {
+        return { ok: false, error: `project ${projectKey} has no status named ${missing.map((name) => `"${name}"`).join(', ')}` };
+    }
+    const statusIds = statusNames.flatMap((name) => idsByName.get(name.toLowerCase()) ?? []);
+    return { ok: true, statusIds: [...new Set(statusIds)] };
+}
+/**
+ * @description Name a project's `extraFields` ids from the site's field list. An
+ * id the site does not list is `unknown`: the connector logs it once at boot and
+ * leaves it out of every prompt (C11) — a typo must not stop the whole instance.
+ */
+function resolveExtraFields(extraFieldIds, fieldDefinitions) {
+    const nameById = new Map(fieldDefinitions.map((definition) => [definition.id, definition.name]));
+    const extraFields = [];
+    const unknownFieldIds = [];
+    for (const id of extraFieldIds) {
+        const name = nameById.get(id);
+        if (name === undefined)
+            unknownFieldIds.push(id);
+        else
+            extraFields.push({ id, name });
+    }
+    return { extraFields, unknownFieldIds };
+}
+//# sourceMappingURL=config.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * @description Where the Jira connector's configuration lives (plan J4, D10).
+ * Kept apart from `config.ts` because the CLI preflight checks the file exists
+ * before any env file is loaded, and must not pull in the modules validation
+ * needs (adapters, the OpenCode manager, the MCP layer).
+ */
+/** The file under `DATA_DIR`. */
+export declare const jiraConfigFileName = "jira.json";
+export declare function getJiraConfigPath(dataDir: string): string;
+//# sourceMappingURL=configFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configFile.d.ts","sourceRoot":"","sources":["../../../src/connectors/jira/configFile.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/connectors/jira/configFile.js

@@ -0,0 +1,50 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jiraConfigFileName = void 0;
+exports.getJiraConfigPath = getJiraConfigPath;
+const path = __importStar(require("path"));
+/**
+ * @description Where the Jira connector's configuration lives (plan J4, D10).
+ * Kept apart from `config.ts` because the CLI preflight checks the file exists
+ * before any env file is loaded, and must not pull in the modules validation
+ * needs (adapters, the OpenCode manager, the MCP layer).
+ */
+/** The file under `DATA_DIR`. */
+exports.jiraConfigFileName = 'jira.json';
+function getJiraConfigPath(dataDir) {
+    return path.join(dataDir, exports.jiraConfigFileName);
+}
+//# sourceMappingURL=configFile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configFile.js","sourceRoot":"","sources":["../../../src/connectors/jira/configFile.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,8CAEC;AAdD,2CAA6B;AAE7B;;;;;GAKG;AAEH,iCAAiC;AACpB,QAAA,kBAAkB,GAAG,WAAW,CAAC;AAE9C,SAAgB,iBAAiB,CAAC,OAAe;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,0BAAkB,CAAC,CAAC;AAChD,CAAC"}

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

@@ -0,0 +1,68 @@
+import { type JiraAnswerSink } from './answerSink';
+import { type JiraConfig } from './config';
+import { type JiraInboundDeps } from './inbound';
+import { type JiraAttachmentToolResult } from './attachmentTool';
+import type { SessionKey } from '../../sessionKey';
+import type { RequestPromptOutcome } from '../../requests/types';
+/**
+ * @description The Jira connector's entry point, loaded by `bot.ts` through a
+ * dynamic `import()` only when `CONNECTORS` lists `jira` (R20). Preparing it
+ * reads and checks everything a poll depends on BEFORE the boot goes on — the
+ * config, that the API token belongs to the configured AI account, each
+ * project's trigger status ids, the trigger log — so a broken setup stops the
+ * start with every reason at once instead of failing on the first poll.
+ */
+export declare class JiraConnectorStartError extends Error {
+    readonly reasons: string[];
+    constructor(reasons: string[]);
+}
+/** What the connector needs from the core to open and post requests. */
+export type JiraConnectorSessionDeps = Pick<JiraInboundDeps, 'bindConversation' | 'createRequest' | 'postRequest'>;
+export interface JiraConnector {
+    /** The backend Jira sessions run on (D16, R14). */
+    adapterName: JiraConfig['adapter'];
+    /** `jira.json`'s model and effort for new sessions (R15). */
+    launchDefaults: {
+        model: string;
+        effort: string;
+    };
+    /** Where answers, alerts and park notices go: comments on the issue (J6). */
+    answerSink: JiraAnswerSink;
+    /**
+     * What became of a request's prompt (the request ledger's event, C4): taken in → what it carried counts as
+     * sent to the issue's conversation; dropped → it never does.
+     */
+    onPromptSettled(key: SessionKey, requestId: string, outcome: RequestPromptOutcome): void;
+    /** The issue's agent lost what it was told (a fresh session, a completed compaction): the next prompt is whole (C6). */
+    onContextReset(key: SessionKey, reason: string): void;
+    /**
+     * `jira_get_attachment` (C10): download attachment `attachmentId` of the issue `key` names — and no other
+     * issue's — into the conversation's files dir. The key comes from the session's scoped token, never from the agent.
+     */
+    fetchAttachment(key: SessionKey, attachmentId: string): Promise<JiraAttachmentToolResult>;
+    /** Start polling (the session side is ready: the boot restored the sessions). */
+    start(deps: JiraConnectorSessionDeps): void;
+    stop(): void;
+}
+/**
+ * @description R22: a failure that says nothing about the setup — no answer, a
+ * 5xx, a 429 after the client's own retries. A refused token (401/403) or any
+ * other 4xx (an unknown project) is the setup's fault.
+ */
+export declare function checkIsTransientJiraFailure(error: Error): boolean;
+/** The connector's own folders inside a conversation's files dir: its downloads, and under them the text too long for a prompt. */
+export declare const jiraFilesDirName = "jira";
+export declare const jiraSpillDirName = "text";
+/** The start-of-polling log line that carries the poll's JQL. */
+export declare const jiraPollJqlLogPrefix = "[jira] poll JQL: ";
+export declare function prepareJiraConnector(context: {
+    dataDir: string;
+    workRoot: string;
+    openCodeUrl: string | undefined;
+    /** Tests only: a shorter base for the setup re-check's backoff (default: the poll interval) and the client's retry sleep. */
+    testTiming?: {
+        setupRetryBaseMs: number;
+        sleep: (ms: number) => Promise<void>;
+    };
+}): Promise<JiraConnector>;
+//# sourceMappingURL=connector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/connectors/jira/connector.ts"],"names":[],"mappings":"AAGA,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAA+D,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACxG,OAAO,EAAyD,KAAK,eAAe,EAA2B,MAAM,WAAW,CAAC;AAGjI,OAAO,EAAwB,KAAK,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAGvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAIjE;;;;;;;GAOG;AAEH,qBAAa,uBAAwB,SAAQ,KAAK;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE;gBAAjB,OAAO,EAAE,MAAM,EAAE;CAIvC;AAED,wEAAwE;AACxE,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,eAAe,EAAE,kBAAkB,GAAG,eAAe,GAAG,aAAa,CAAC,CAAC;AAEnH,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,WAAW,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACnC,6DAA6D;IAC7D,cAAc,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,6EAA6E;IAC7E,UAAU,EAAE,cAAc,CAAC;IAC3B;;;OAGG;IACH,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACzF,wHAAwH;IACxH,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD;;;OAGG;IACH,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC1F,iFAAiF;IACjF,KAAK,CAAC,IAAI,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAC5C,IAAI,IAAI,IAAI,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAIjE;AAkED,mIAAmI;AACnI,eAAO,MAAM,gBAAgB,SAAS,CAAC;AACvC,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAEvC,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAExD,wBAAsB,oBAAoB,CAAC,OAAO,EAAE;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,6HAA6H;IAC7H,UAAU,CAAC,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;CACjF,GAAG,OAAO,CAAC,aAAa,CAAC,CA2GzB"}