lorenz 0.1.0

package/extensions/linear-tracker/dist/index.js

@@ -0,0 +1,7 @@
+export { LinearGraphQLClient } from "@linear/sdk";
+export { LinearClient } from "./client.js";
+export { LINEAR_DEFAULT_ENDPOINT, linearEndpoint, linearTrackerOptions, } from "./options.js";
+export { linearTrackerProvider } from "./provider.js";
+export { executeLinearTool, linearToolProvider, linearToolSpecs } from "./tools.js";
+export { registerLinearTracker } from "./register.js";
+//# sourceMappingURL=index.js.map

package/extensions/linear-tracker/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ3C,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,oBAAoB,GAErB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/extensions/linear-tracker/dist/options.d.ts

@@ -0,0 +1,32 @@
+import type { Settings } from "@lorenz/domain";
+export declare const LINEAR_DEFAULT_ENDPOINT = "https://api.linear.app/graphql";
+/** Linear-specific keys of the selected tracker bundle, validated by the provider. */
+export interface LinearTrackerOptions {
+    /** @deprecated Use `projectSlugs` instead. Single Linear project slug. */
+    projectSlug?: string | undefined;
+    /** Linear project slugs to monitor. Mutually exclusive with `projectLabels`. */
+    projectSlugs?: string[] | undefined;
+    /** Linear project labels for dynamic discovery. Mutually exclusive with `projectSlugs`. */
+    projectLabels?: string[] | undefined;
+}
+/** Typed view over `settings.tracker.options` for the Linear provider. */
+export declare function linearTrackerOptions(settings: Settings): LinearTrackerOptions;
+/** The configured Linear API endpoint, falling back to the public GraphQL endpoint. */
+export declare function linearEndpoint(settings: Settings): string;
+/** Credential and endpoint the mounted linear TOOL pack calls Linear with. */
+export interface LinearToolPackOptions {
+    apiKey?: string | undefined;
+    endpoint: string;
+}
+/**
+ * Auth resolution for the linear TOOL pack. Prefers the pack's own `tools.linear` slice
+ * (secret references already resolved at config-parse time), then the dispatch tracker's
+ * credential and endpoint only when Linear itself drives dispatch.
+ */
+export declare function linearToolPackOptions(settings: Settings): LinearToolPackOptions;
+/**
+ * Validate the pack's `tools.linear` slice; backs `linearToolProvider.validateOptions`.
+ * Errors name the offending `tools.linear.<key>` so config typos fail at startup.
+ */
+export declare function validateLinearToolOptions(options: Record<string, unknown>): void;
+//# sourceMappingURL=options.d.ts.map

package/extensions/linear-tracker/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AAExE,sFAAsF;AACtF,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACpC,2FAA2F;IAC3F,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACtC;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,oBAAoB,CAO7E;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAEzD;AASD,8EAA8E;AAC9E,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,qBAAqB,CAU/E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEhF"}

package/extensions/linear-tracker/dist/options.js

@@ -0,0 +1,59 @@
+import { stringListOption, stringOption } from "@lorenz/tracker-sdk";
+export const LINEAR_DEFAULT_ENDPOINT = "https://api.linear.app/graphql";
+/** Typed view over `settings.tracker.options` for the Linear provider. */
+export function linearTrackerOptions(settings) {
+    const options = settings.tracker.options;
+    return {
+        projectSlug: stringOption(options, "projectSlug") || undefined,
+        projectSlugs: stringListOption(options, "projectSlugs"),
+        projectLabels: stringListOption(options, "projectLabels"),
+    };
+}
+/** The configured Linear API endpoint, falling back to the public GraphQL endpoint. */
+export function linearEndpoint(settings) {
+    return settings.tracker.endpoint ?? LINEAR_DEFAULT_ENDPOINT;
+}
+/** Keys of the pack's `tools.linear` slice. */
+const LINEAR_PACK_OPTION_KEYS = {
+    apiKey: "apiKey",
+    api_key: "apiKey",
+    endpoint: "endpoint",
+};
+/**
+ * Auth resolution for the linear TOOL pack. Prefers the pack's own `tools.linear` slice
+ * (secret references already resolved at config-parse time), then the dispatch tracker's
+ * credential and endpoint only when Linear itself drives dispatch.
+ */
+export function linearToolPackOptions(settings) {
+    const packOptions = normalizeLinearPackOptions(settings.toolOptions?.["linear"] ?? {});
+    const dispatchIsLinear = settings.tracker.kind === "linear";
+    const apiKey = packOptions.apiKey || (dispatchIsLinear ? settings.tracker.apiKey : undefined) || undefined;
+    const endpoint = packOptions.endpoint ??
+        (dispatchIsLinear ? settings.tracker.endpoint : undefined) ??
+        LINEAR_DEFAULT_ENDPOINT;
+    return { apiKey, endpoint };
+}
+/**
+ * Validate the pack's `tools.linear` slice; backs `linearToolProvider.validateOptions`.
+ * Errors name the offending `tools.linear.<key>` so config typos fail at startup.
+ */
+export function validateLinearToolOptions(options) {
+    normalizeLinearPackOptions(options);
+}
+function normalizeLinearPackOptions(options) {
+    const normalized = {};
+    for (const [key, value] of Object.entries(options)) {
+        const canonical = LINEAR_PACK_OPTION_KEYS[key];
+        if (canonical === undefined) {
+            throw new Error(`tools.linear.${key} is not supported (known keys: ${Object.keys(LINEAR_PACK_OPTION_KEYS).join(", ")})`);
+        }
+        if (value === undefined || value === null)
+            continue;
+        if (typeof value !== "string") {
+            throw new Error(`tools.linear.${key} must be a string`);
+        }
+        normalized[canonical] = value;
+    }
+    return normalized;
+}
+//# sourceMappingURL=options.js.map

package/extensions/linear-tracker/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAErE,MAAM,CAAC,MAAM,uBAAuB,GAAG,gCAAgC,CAAC;AAYxE,0EAA0E;AAC1E,MAAM,UAAU,oBAAoB,CAAC,QAAkB;IACrD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;IACzC,OAAO;QACL,WAAW,EAAE,YAAY,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,SAAS;QAC9D,YAAY,EAAE,gBAAgB,CAAC,OAAO,EAAE,cAAc,CAAC;QACvD,aAAa,EAAE,gBAAgB,CAAC,OAAO,EAAE,eAAe,CAAC;KAC1D,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,cAAc,CAAC,QAAkB;IAC/C,OAAO,QAAQ,CAAC,OAAO,CAAC,QAAQ,IAAI,uBAAuB,CAAC;AAC9D,CAAC;AAED,+CAA+C;AAC/C,MAAM,uBAAuB,GAA0C;IACrE,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,UAAU;CACrB,CAAC;AAQF;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAkB;IACtD,MAAM,WAAW,GAAG,0BAA0B,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACvF,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC;IAC5D,MAAM,MAAM,GACV,WAAW,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC;IAC9F,MAAM,QAAQ,GACZ,WAAW,CAAC,QAAQ;QACpB,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1D,uBAAuB,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAgC;IACxE,0BAA0B,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,0BAA0B,CAAC,OAAgC;IAIlE,MAAM,UAAU,GAAmE,EAAE,CAAC;IACtF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,SAAS,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,gBAAgB,GAAG,kCAAkC,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACxG,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,gBAAgB,GAAG,mBAAmB,CAAC,CAAC;QAC1D,CAAC;QACD,UAAU,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;IAChC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/extensions/linear-tracker/dist/provider.d.ts

@@ -0,0 +1,4 @@
+import type { TrackerProvider } from "@lorenz/tracker-sdk";
+/** Linear.app tracker: issues are polled from configured projects over GraphQL. */
+export declare const linearTrackerProvider: TrackerProvider;
+//# sourceMappingURL=provider.d.ts.map

package/extensions/linear-tracker/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAY3D,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,EAAE,eAsDnC,CAAC"}

package/extensions/linear-tracker/dist/provider.js

@@ -0,0 +1,58 @@
+import { rejectUnknownOptions, resolveEnvReference, stringListOption, stringOption, } from "@lorenz/tracker-sdk";
+import { LinearClient } from "./client.js";
+import { LINEAR_DEFAULT_ENDPOINT, linearTrackerOptions } from "./options.js";
+import { linearToolOps } from "./toolOps.js";
+/** Linear.app tracker: issues are polled from configured projects over GraphQL. */
+export const linearTrackerProvider = {
+    kind: "linear",
+    configAliases: {
+        project_slug: "projectSlug",
+        project_slugs: "projectSlugs",
+        project_labels: "projectLabels",
+    },
+    envFallbacks: { apiKey: "LINEAR_API_KEY", assignee: "LINEAR_ASSIGNEE" },
+    defaultEndpoint: LINEAR_DEFAULT_ENDPOINT,
+    parseOptions(options, context) {
+        rejectUnknownOptions(options, ["projectSlug", "projectSlugs", "projectLabels"], "linear");
+        const projectSlugRaw = stringOption(options, "projectSlug");
+        const projectSlug = projectSlugRaw === undefined
+            ? undefined
+            : resolveEnvReference(projectSlugRaw, context.env) || undefined;
+        const projectSlugs = stringListOption(options, "projectSlugs");
+        const projectLabels = stringListOption(options, "projectLabels");
+        return {
+            ...(projectSlug !== undefined ? { projectSlug } : {}),
+            ...(projectSlugs !== undefined ? { projectSlugs } : {}),
+            ...(projectLabels !== undefined ? { projectLabels } : {}),
+        };
+    },
+    validateDispatch(settings) {
+        if (!settings.tracker.apiKey)
+            throw new Error("tracker.api_key is required");
+        const { projectSlug, projectSlugs, projectLabels } = linearTrackerOptions(settings);
+        const configured = [!!projectSlug, !!projectSlugs?.length, !!projectLabels?.length];
+        const count = configured.filter(Boolean).length;
+        if (count === 0) {
+            throw new Error("tracker.project_slug, tracker.project_slugs, or tracker.project_labels is required");
+        }
+        if (count > 1) {
+            throw new Error("tracker.project_slug, tracker.project_slugs, and tracker.project_labels are mutually exclusive");
+        }
+    },
+    createClient(settings) {
+        const client = new LinearClient(settings);
+        // Resolve project slugs (e.g. from project_labels) in the background so the first poll
+        // does not pay the discovery round-trip.
+        void client.resolveProjectSlugs().catch(() => { });
+        return client;
+    },
+    createToolOps: (settings, context) => linearToolOps(settings, context),
+    defaultToolPacks: () => ["linear"],
+    projectUrl(settings) {
+        const slug = linearTrackerOptions(settings).projectSlug?.trim();
+        if (!slug)
+            return undefined;
+        return `https://linear.app/project/${encodeURIComponent(slug)}/issues`;
+    },
+};
+//# sourceMappingURL=provider.js.map

package/extensions/linear-tracker/dist/provider.js.map

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

package/extensions/linear-tracker/dist/register.d.ts

@@ -0,0 +1,11 @@
+import { type ToolRegistry } from "@lorenz/tool-sdk";
+import { type TrackerRegistry } from "@lorenz/tracker-sdk";
+/**
+ * Register this extension's tracker provider and tool pack. Idempotent; called by the
+ * composition root (or a test) against its registries, defaulting to the process-wide ones.
+ */
+export declare function registerLinearTracker(registries?: {
+    trackers?: TrackerRegistry;
+    tools?: ToolRegistry;
+}): void;
+//# sourceMappingURL=register.d.ts.map

package/extensions/linear-tracker/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAKnF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,GAAE;IAAE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAAC,KAAK,CAAC,EAAE,YAAY,CAAA;CAAO,GACpE,IAAI,CASN"}

package/extensions/linear-tracker/dist/register.js

@@ -0,0 +1,19 @@
+import { defaultToolRegistry } from "@lorenz/tool-sdk";
+import { defaultTrackerRegistry } from "@lorenz/tracker-sdk";
+import { linearTrackerProvider } from "./provider.js";
+import { linearToolProvider } from "./tools.js";
+/**
+ * Register this extension's tracker provider and tool pack. Idempotent; called by the
+ * composition root (or a test) against its registries, defaulting to the process-wide ones.
+ */
+export function registerLinearTracker(registries = {}) {
+    const trackers = registries.trackers ?? defaultTrackerRegistry;
+    const tools = registries.tools ?? defaultToolRegistry;
+    if (trackers.get(linearTrackerProvider.kind) === undefined) {
+        trackers.register(linearTrackerProvider);
+    }
+    if (tools.get(linearToolProvider.name) === undefined) {
+        tools.register(linearToolProvider);
+    }
+}
+//# sourceMappingURL=register.js.map

package/extensions/linear-tracker/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAqB,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAwB,MAAM,qBAAqB,CAAC;AAEnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,aAAmE,EAAE;IAErE,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,sBAAsB,CAAC;IAC/D,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,mBAAmB,CAAC;IACtD,IAAI,QAAQ,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QAC3D,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QACrD,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IACrC,CAAC;AACH,CAAC"}

package/extensions/linear-tracker/dist/toolOps.d.ts

@@ -0,0 +1,8 @@
+import { type Settings } from "@lorenz/domain";
+import type { TrackerOpsContext, TrackerToolOps } from "@lorenz/tracker-sdk";
+/**
+ * Normalized issue operations behind the provider-neutral `tracker_*` pack, implemented over
+ * the same GraphQL transport as the `linear_graphql` tool (credentials, retries, logging).
+ */
+export declare function linearToolOps(settings: Settings, context: TrackerOpsContext): TrackerToolOps;
+//# sourceMappingURL=toolOps.d.ts.map

package/extensions/linear-tracker/dist/toolOps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolOps.d.ts","sourceRoot":"","sources":["../src/toolOps.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,KAAK,EAEV,iBAAiB,EACjB,cAAc,EACf,MAAM,qBAAqB,CAAC;AA0B7B;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,GAAG,cAAc,CAU5F"}

package/extensions/linear-tracker/dist/toolOps.js

@@ -0,0 +1,160 @@
+import { normalizeIssue } from "@lorenz/issue";
+import { isRecord } from "@lorenz/domain";
+import { linearTrackerOptions } from "./options.js";
+import { executeLinearTool } from "./tools.js";
+const linearIssueFields = `
+  id
+  identifier
+  title
+  description
+  priority
+  state { id name type }
+  branchName
+  url
+  assignee { id }
+  labels(first: 50) { nodes { name } }
+  inverseRelations(first: 50) {
+    nodes {
+      type
+      issue { id identifier state { name type } }
+    }
+  }
+  createdAt
+  updatedAt
+`;
+/**
+ * Normalized issue operations behind the provider-neutral `tracker_*` pack, implemented over
+ * the same GraphQL transport as the `linear_graphql` tool (credentials, retries, logging).
+ */
+export function linearToolOps(settings, context) {
+    const { fetchImpl } = context;
+    return {
+        readIssue: async (issueId) => readLinearIssue(settings, issueId, fetchImpl),
+        queryIssues: async (args) => queryLinearIssues(settings, args, fetchImpl),
+        updateStatus: async (issueId, status) => updateLinearStatus(settings, issueId, status, fetchImpl),
+        addComment: async (issueId, body) => createLinearComment(settings, issueId, body, fetchImpl),
+        createIssue: async (input) => createLinearIssue(settings, input, fetchImpl),
+    };
+}
+async function readLinearIssue(settings, issueId, fetchImpl) {
+    const data = await linearData(settings, `query SymphonyTrackerReadIssue($id: String!) {
+      issue(id: $id) { ${linearIssueFields} }
+    }`, { id: issueId }, fetchImpl);
+    if (!data.issue)
+        throw new Error(`linear issue not found: ${issueId}`);
+    return normalizeLinearIssue(data.issue, settings.tracker.assignee);
+}
+async function queryLinearIssues(settings, args, fetchImpl) {
+    const issueIds = stringArray(args.issueIds);
+    if (issueIds) {
+        const data = await linearData(settings, `query SymphonyTrackerIssuesById($ids: [ID!]!, $first: Int!) {
+        issues(filter: {id: {in: $ids}}, first: $first) { nodes { ${linearIssueFields} } }
+      }`, { ids: issueIds, first: issueIds.length }, fetchImpl);
+        return data.issues.nodes.map((issue) => normalizeLinearIssue(issue, settings.tracker.assignee));
+    }
+    const states = stringArray(args.states) ?? settings.tracker.activeStates;
+    const options = linearTrackerOptions(settings);
+    const projectSlugs = options.projectSlugs ?? (options.projectSlug ? [options.projectSlug] : []);
+    const data = await linearData(settings, `query SymphonyTrackerQuery($projectSlugs: [String!]!, $stateNames: [String!]!, $first: Int!) {
+      issues(filter: {project: {slugId: {in: $projectSlugs}}, state: {name: {in: $stateNames}}}, first: $first) {
+        nodes { ${linearIssueFields} }
+      }
+    }`, { projectSlugs, stateNames: states, first: numberArg(args.limit, 50) }, fetchImpl);
+    return data.issues.nodes.map((issue) => normalizeLinearIssue(issue, settings.tracker.assignee));
+}
+async function updateLinearStatus(settings, issueId, status, fetchImpl) {
+    const lookup = await linearData(settings, `query SymphonyTrackerLinearStates($id: String!) {
+      issue(id: $id) { team { states(first: 100) { nodes { id name } } } }
+    }`, { id: issueId }, fetchImpl);
+    const state = lookup.issue?.team?.states?.nodes?.find((candidate) => candidate.name.trim().toLowerCase() === status.trim().toLowerCase());
+    if (!state)
+        throw new Error(`linear state not found: ${status}`);
+    const data = await linearData(settings, `mutation SymphonyTrackerLinearUpdate($id: String!, $input: IssueUpdateInput!) {
+      issueUpdate(id: $id, input: $input) { success issue { ${linearIssueFields} } }
+    }`, { id: issueId, input: { stateId: state.id } }, fetchImpl);
+    if (!data.issueUpdate.success || !data.issueUpdate.issue)
+        throw new Error("linear issueUpdate failed");
+    return normalizeLinearIssue(data.issueUpdate.issue, settings.tracker.assignee);
+}
+async function createLinearComment(settings, issueId, body, fetchImpl) {
+    const data = await linearData(settings, `mutation SymphonyTrackerLinearComment($input: CommentCreateInput!) {
+      commentCreate(input: $input) { success }
+    }`, { input: { issueId, body } }, fetchImpl);
+    if (!data.commentCreate.success)
+        throw new Error("linear commentCreate failed");
+}
+async function createLinearIssue(settings, input, fetchImpl) {
+    const options = linearTrackerOptions(settings);
+    const projectSlug = options.projectSlug ?? options.projectSlugs?.[0];
+    if (!projectSlug)
+        throw new Error("tracker.project_slug is required to create Linear issues");
+    const projectData = await linearData(settings, `query SymphonyTrackerLinearProject($slug: String!) {
+      projects(filter: {slugId: {eq: $slug}}, first: 1) {
+        nodes { id teams(first: 1) { nodes { id states(first: 100) { nodes { id name type } } } } }
+      }
+    }`, { slug: projectSlug }, fetchImpl);
+    const project = projectData.projects.nodes[0];
+    const team = project?.teams.nodes[0];
+    if (!project || !team)
+        throw new Error(`linear project not found: ${projectSlug}`);
+    const state = team.states.nodes.find((candidate) => candidate.name === input.status) ??
+        team.states.nodes.find((candidate) => candidate.type === "unstarted") ??
+        team.states.nodes[0];
+    if (!state)
+        throw new Error("linear project has no workflow states");
+    const assignee = input.assignee?.trim() || settings.tracker.assignee?.trim();
+    const data = await linearData(settings, `mutation SymphonyTrackerLinearCreate($input: IssueCreateInput!) {
+      issueCreate(input: $input) { success issue { ${linearIssueFields} } }
+    }`, {
+        input: {
+            teamId: team.id,
+            projectId: project.id,
+            stateId: state.id,
+            title: input.title,
+            description: input.body ?? "",
+            ...(assignee ? { assigneeId: assignee } : {}),
+        },
+    }, fetchImpl);
+    if (!data.issueCreate.success || !data.issueCreate.issue)
+        throw new Error("linear issueCreate failed");
+    return normalizeLinearIssue(data.issueCreate.issue, settings.tracker.assignee);
+}
+async function linearData(settings, query, variables, fetchImpl) {
+    const result = await executeLinearTool("linear_graphql", { query, variables }, settings, fetchImpl);
+    if (!result.success)
+        throw new Error(result.error ?? "linear_graphql failed");
+    const body = result.result;
+    if (!isRecord(body) || !isRecord(body.data))
+        throw new Error("linear_graphql returned no data");
+    return body.data;
+}
+function normalizeLinearIssue(issue, assignee) {
+    return normalizeIssue({
+        ...issue,
+        state: issue.state,
+        state_type: isRecord(issue.state) ? issue.state.type : null,
+        branch_name: issue.branchName,
+        assignee_id: isRecord(issue.assignee) ? issue.assignee.id : null,
+        labels: nodesFromConnection(issue.labels),
+        relations: nodesFromConnection(issue.inverseRelations),
+        created_at: issue.createdAt,
+        updated_at: issue.updatedAt,
+    }, assignee);
+}
+function nodesFromConnection(value) {
+    if (!isRecord(value) || !Array.isArray(value.nodes))
+        return [];
+    return value.nodes;
+}
+function stringArray(value) {
+    if (value === undefined || value === null)
+        return null;
+    if (!Array.isArray(value) || !value.every((entry) => typeof entry === "string")) {
+        throw new Error("expected an array of strings");
+    }
+    return value;
+}
+function numberArg(value, fallback) {
+    return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : fallback;
+}
+//# sourceMappingURL=toolOps.js.map

package/extensions/linear-tracker/dist/toolOps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolOps.js","sourceRoot":"","sources":["../src/toolOps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAA6B,MAAM,gBAAgB,CAAC;AAOrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;CAmBzB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAkB,EAAE,OAA0B;IAC1E,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAC9B,OAAO;QACL,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC;QAC3E,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC;QACzE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CACtC,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC;QAC1D,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC;QAC5F,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC;KAC5E,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,QAAkB,EAClB,OAAe,EACf,SAAuB;IAEvB,MAAM,IAAI,GAAG,MAAM,UAAU,CAC3B,QAAQ,EACR;yBACqB,iBAAiB;MACpC,EACF,EAAE,EAAE,EAAE,OAAO,EAAE,EACf,SAAS,CACV,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;IACvE,OAAO,oBAAoB,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACrE,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,QAAkB,EAClB,IAA6B,EAC7B,SAAuB;IAEvB,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,MAAM,UAAU,CAC3B,QAAQ,EACR;oEAC8D,iBAAiB;QAC7E,EACF,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,EACzC,SAAS,CACV,CAAC;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC;IACzE,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChG,MAAM,IAAI,GAAG,MAAM,UAAU,CAC3B,QAAQ,EACR;;kBAEc,iBAAiB;;MAE7B,EACF,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,EACtE,SAAS,CACV,CAAC;IACF,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClG,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,QAAkB,EAClB,OAAe,EACf,MAAc,EACd,SAAuB;IAEvB,MAAM,MAAM,GAAG,MAAM,UAAU,CAG7B,QAAQ,EACR;;MAEE,EACF,EAAE,EAAE,EAAE,OAAO,EAAE,EACf,SAAS,CACV,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CACnD,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CACnF,CAAC;IACF,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,EAAE,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,MAAM,UAAU,CAG3B,QAAQ,EACR;8DAC0D,iBAAiB;MACzE,EACF,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAC7C,SAAS,CACV,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK;QACtD,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,OAAO,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACjF,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,QAAkB,EAClB,OAAe,EACf,IAAY,EACZ,SAAuB;IAEvB,MAAM,IAAI,GAAG,MAAM,UAAU,CAC3B,QAAQ,EACR;;MAEE,EACF,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAC5B,SAAS,CACV,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;AAClF,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,QAAkB,EAClB,KAA8B,EAC9B,SAAuB;IAEvB,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9F,MAAM,WAAW,GAAG,MAAM,UAAU,CAalC,QAAQ,EACR;;;;MAIE,EACF,EAAE,IAAI,EAAE,WAAW,EAAE,EACrB,SAAS,CACV,CAAC;IACF,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,WAAW,EAAE,CAAC,CAAC;IACnF,MAAM,KAAK,GACT,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,WAAW,CAAC;QACrE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC7E,MAAM,IAAI,GAAG,MAAM,UAAU,CAG3B,QAAQ,EACR;qDACiD,iBAAiB;MAChE,EACF;QACE,KAAK,EAAE;YACL,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,WAAW,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;YAC7B,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C;KACF,EACD,SAAS,CACV,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK;QACtD,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,OAAO,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACjF,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,QAAkB,EAClB,KAAa,EACb,SAAkC,EAClC,SAAuB;IAEvB,MAAM,MAAM,GAAG,MAAM,iBAAiB,CACpC,gBAAgB,EAChB,EAAE,KAAK,EAAE,SAAS,EAAE,EACpB,QAAQ,EACR,SAAS,CACV,CAAC;IACF,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,uBAAuB,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAChG,OAAO,IAAI,CAAC,IAAS,CAAC;AACxB,CAAC;AAED,SAAS,oBAAoB,CAAC,KAA8B,EAAE,QAAiB;IAC7E,OAAO,cAAc,CACnB;QACE,GAAG,KAAK;QACR,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QAC3D,WAAW,EAAE,KAAK,CAAC,UAAU;QAC7B,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;QAChE,MAAM,EAAE,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC;QACzC,SAAS,EAAE,mBAAmB,CAAC,KAAK,CAAC,gBAAgB,CAAC;QACtD,UAAU,EAAE,KAAK,CAAC,SAAS;QAC3B,UAAU,EAAE,KAAK,CAAC,SAAS;KAC5B,EACD,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/D,OAAO,KAAK,CAAC,KAAK,CAAC;AACrB,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,KAAc,EAAE,QAAgB;IACjD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC9F,CAAC"}

package/extensions/linear-tracker/dist/tools.d.ts

@@ -0,0 +1,7 @@
+import { type Settings } from "@lorenz/domain";
+import { type ToolProvider, type ToolResult, type ToolSpec } from "@lorenz/tool-sdk";
+export declare function linearToolSpecs(): ToolSpec[];
+export declare function executeLinearTool(name: string, input: unknown, settings: Settings, fetchImpl?: typeof fetch): Promise<ToolResult>;
+/** The Linear tool pack: raw GraphQL access using the pack's own Linear credentials. */
+export declare const linearToolProvider: ToolProvider;
+//# sourceMappingURL=tools.d.ts.map

package/extensions/linear-tracker/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAGA,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,QAAQ,EACd,MAAM,kBAAkB,CAAC;AA6B1B,wBAAgB,eAAe,IAAI,QAAQ,EAAE,CAuB5C;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,QAAQ,EAClB,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,UAAU,CAAC,CA2DrB;AAED,wFAAwF;AACxF,eAAO,MAAM,kBAAkB,EAAE,YAOhC,CAAC"}

package/extensions/linear-tracker/dist/tools.js

@@ -0,0 +1,210 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { errorMessage, isRecord } from "@lorenz/domain";
+import { toolFailure, toolSuccess, unsupportedToolFailure, } from "@lorenz/tool-sdk";
+import { linearToolPackOptions, validateLinearToolOptions } from "./options.js";
+/**
+ * The `symphony-linear` skill ships inside this extension (`skills/symphony-linear`, a sibling
+ * of `src`/`dist`) so mounting the Linear pack also overlays the doc that teaches the agent to
+ * call `linear_graphql`. Resolved from this module so it works from both `src` and `dist`.
+ */
+const symphonyLinearSkillDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "skills", "symphony-linear");
+const LINEAR_MAX_RETRIES = 4;
+const MAX_ERROR_BODY_LOG_BYTES = 1000;
+const defaultLinearToolLogger = {
+    warn: (message) => console.warn(message),
+    error: (message) => console.error(message),
+};
+export function linearToolSpecs() {
+    return [
+        {
+            name: "linear_graphql",
+            description: "Run a Linear GraphQL operation using Symphony's configured Linear credentials.",
+            inputSchema: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "GraphQL query or mutation document to execute against Linear.",
+                    },
+                    variables: {
+                        type: ["object", "null"],
+                        description: "Optional GraphQL variables object.",
+                        additionalProperties: true,
+                    },
+                },
+                required: ["query"],
+            },
+        },
+    ];
+}
+export async function executeLinearTool(name, input, settings, fetchImpl = fetch) {
+    if (name !== "linear_graphql") {
+        return unsupportedToolFailure(name, ["linear_graphql"]);
+    }
+    const normalizedInput = normalizeLinearGraphqlInput(input);
+    if (!normalizedInput.ok) {
+        return toolFailure(normalizedInput.error);
+    }
+    const { apiKey, endpoint } = linearToolPackOptions(settings);
+    if (!apiKey)
+        return toolFailure("Symphony is missing Linear auth. Set `linear.api_key` in `WORKFLOW.md` or export `LINEAR_API_KEY`.");
+    if (normalizedInput.variables !== undefined &&
+        normalizedInput.variables !== null &&
+        !isRecord(normalizedInput.variables)) {
+        return toolFailure("`linear_graphql.variables` must be a JSON object when provided.");
+    }
+    try {
+        const logger = defaultLinearToolLogger;
+        const response = await fetchWithRateLimitRetry(fetchImpl, { apiKey, endpoint }, normalizedInput.query, normalizedInput.variables ?? {}, logger);
+        const bodyResult = await readResponseJson(response);
+        if (!bodyResult.ok) {
+            if (!response.ok) {
+                logStatusError(logger, normalizedInput.query, response.status, bodyResult.rawBody);
+                return toolFailure(`Linear GraphQL request failed with HTTP ${response.status}.`, {
+                    status: response.status,
+                });
+            }
+            return toolFailure(`linear_invalid_json: ${errorMessage(bodyResult.error)}`);
+        }
+        const body = bodyResult.body;
+        if (!response.ok) {
+            logStatusError(logger, normalizedInput.query, response.status, body);
+            return toolFailure(`Linear GraphQL request failed with HTTP ${response.status}.`, {
+                status: response.status,
+            });
+        }
+        if (isRecord(body) && Array.isArray(body.errors) && body.errors.length > 0) {
+            return { success: false, result: body };
+        }
+        return toolSuccess(body);
+    }
+    catch (error) {
+        defaultLinearToolLogger.error(`Linear GraphQL request failed: ${errorMessage(error)}${linearErrorContext(normalizedInput.query)}`);
+        return toolFailure("Linear GraphQL request failed before receiving a successful response.", {
+            reason: errorMessage(error),
+        });
+    }
+}
+/** The Linear tool pack: raw GraphQL access using the pack's own Linear credentials. */
+export const linearToolProvider = {
+    name: "linear",
+    skills: [symphonyLinearSkillDir],
+    validateOptions: validateLinearToolOptions,
+    toolSpecs: () => linearToolSpecs(),
+    executeTool: async (name, input, context) => executeLinearTool(name, input, context.settings, context.fetchImpl),
+};
+function normalizeLinearGraphqlInput(input) {
+    if (typeof input === "string") {
+        if (input.trim() === "")
+            return { ok: false, error: "`linear_graphql` requires a non-empty `query` string." };
+        return { ok: true, query: input };
+    }
+    if (!isRecord(input) || typeof input.query !== "string") {
+        return { ok: false, error: "`linear_graphql` requires a non-empty `query` string." };
+    }
+    if (input.query.trim() === "")
+        return { ok: false, error: "`linear_graphql` requires a non-empty `query` string." };
+    if (input.variables !== undefined && input.variables !== null && !isRecord(input.variables)) {
+        return { ok: false, error: "`linear_graphql.variables` must be a JSON object when provided." };
+    }
+    return {
+        ok: true,
+        query: input.query,
+        variables: input.variables,
+    };
+}
+async function fetchWithRateLimitRetry(fetchImpl, auth, query, variables, logger) {
+    for (let retryCount = 0;; retryCount += 1) {
+        const response = await fetchImpl(auth.endpoint, {
+            method: "POST",
+            signal: AbortSignal.timeout(30_000),
+            headers: {
+                "content-type": "application/json",
+                authorization: auth.apiKey,
+            },
+            body: JSON.stringify({ query, variables }),
+        });
+        if (response.status !== 429 || retryCount >= LINEAR_MAX_RETRIES)
+            return response;
+        const delayMs = retryDelayMs(response.headers, retryCount);
+        logger.warn(`Linear GraphQL request rate limited status=429 retry=${retryCount + 1}/${LINEAR_MAX_RETRIES} delay_ms=${delayMs}${linearErrorContext(query, await responseBodyForLog(response))}`);
+        await sleep(delayMs);
+    }
+}
+function retryDelayMs(headers, retryCount) {
+    const retryAfter = headers.get("retry-after");
+    if (retryAfter !== null) {
+        const seconds = Number(retryAfter.trim());
+        if (Number.isInteger(seconds) && seconds >= 0)
+            return seconds * 1000;
+        const dateMs = Date.parse(retryAfter.trim());
+        if (!Number.isNaN(dateMs))
+            return Math.max(0, dateMs - Date.now());
+    }
+    return Math.min(1_000 * 2 ** retryCount, 30_000);
+}
+async function sleep(delayMs) {
+    await new Promise((resolve) => setTimeout(resolve, delayMs));
+}
+async function readResponseJson(response) {
+    let rawBody;
+    try {
+        rawBody = await response.text();
+    }
+    catch (error) {
+        return { ok: false, error };
+    }
+    try {
+        return { ok: true, body: JSON.parse(rawBody) };
+    }
+    catch (error) {
+        return { ok: false, error, rawBody };
+    }
+}
+async function responseBodyForLog(response) {
+    try {
+        const rawBody = await response.clone().text();
+        try {
+            return JSON.parse(rawBody);
+        }
+        catch {
+            return rawBody;
+        }
+    }
+    catch {
+        return undefined;
+    }
+}
+function logStatusError(logger, query, status, body) {
+    logger.error(`Linear GraphQL request failed status=${status}${linearErrorContext(query, body)}`);
+}
+function linearErrorContext(query, body) {
+    const parts = [];
+    const operation = operationName(query);
+    if (operation)
+        parts.push(`operation=${operation}`);
+    if (body !== undefined)
+        parts.push(`body=${summarizeErrorBody(body)}`);
+    return parts.length === 0 ? "" : ` ${parts.join(" ")}`;
+}
+function operationName(query) {
+    return /\b(?:query|mutation)\s+([A-Za-z_][A-Za-z0-9_]*)/.exec(query)?.[1] ?? null;
+}
+function summarizeErrorBody(body) {
+    const text = typeof body === "string" ? body : stringifyErrorBody(body);
+    const compact = text.replace(/\s+/g, " ").trim();
+    if (compact.length <= MAX_ERROR_BODY_LOG_BYTES)
+        return compact;
+    return `${compact.slice(0, MAX_ERROR_BODY_LOG_BYTES)}...<truncated>`;
+}
+function stringifyErrorBody(body) {
+    try {
+        return JSON.stringify(body) ?? String(body);
+    }
+    catch {
+        return String(body);
+    }
+}
+//# sourceMappingURL=tools.js.map