@cat-factory/integrations 0.141.2 → 0.142.0

package/dist/modules/tasks/gitlab-issues.logic.js

@@ -0,0 +1,186 @@
+// GitLab-issues task-source pure logic, the sibling of `github-issues.logic.ts`: the
+// descriptor, the external-id grammar and its round-trip, the ref parser, and the
+// project-scoped search query. Pure, so every rule below is unit-testable without a
+// live API; the fetch itself lives in `GitLabIssuesProvider`.
+//
+// The one structural difference from the GitHub logic drives most of this file: a GitLab
+// project path NESTS. `group/sub/project` is a legal project, and the client folds it into
+// `{ owner: 'group/sub', repo: 'project' }` (splitting at the LAST slash, the same way
+// GitLab's own web URLs read), so an owner here is a multi-segment path where GitHub's is
+// a single account name. Reusing the GitHub grammar would not merely be inconvenient: a
+// subgroup issue would round-trip through it as garbage rather than as a refusal.
+//
+// GitLab issue descriptions are already Markdown, so there is no body-conversion step.
+/**
+ * What the connect UI renders. GitLab issues ride the workspace's existing VCS connection
+ * (the `provider: 'gitlab'` row a PAT connect writes), so there are NO credential fields —
+ * the same credentialless shape GitHub Issues has, keyed on a different connection.
+ */
+export const GITLAB_ISSUES_DESCRIPTOR = {
+    source: 'gitlab',
+    label: 'GitLab Issues',
+    icon: 'i-lucide-gitlab',
+    credentialFields: [],
+    refLabel: 'Issue URL or group/project#number',
+    refPlaceholder: 'acme/web#123  or  https://gitlab.com/acme/web/-/issues/123',
+    searchable: true,
+};
+/** The canonical `group/sub/project#iid` external id for an issue's parts. */
+export function gitlabIssueExternalId(id) {
+    return `${id.owner}/${id.repo}#${id.number}`;
+}
+// A single path segment of a GitLab project path: letters, digits, '.', '_' and '-'.
+const SEG = '[A-Za-z0-9._-]+';
+// A full project path: at least two segments (a namespace and the project), and possibly
+// more, because GitLab nests subgroups. Non-greedy up to the LAST slash so the split below
+// matches how the client folds a web URL.
+const PROJECT_PATH = `${SEG}(?:/${SEG})+`;
+/**
+ * Split a project path at its LAST slash, which is the same fold the GitLab client applies
+ * to a `web_url`: everything before is the namespace (`group/sub`), the final segment is the
+ * project. Returns null for a path with no slash, i.e. one that names no project.
+ */
+function splitProjectPath(path) {
+    const idx = path.lastIndexOf('/');
+    if (idx <= 0 || idx === path.length - 1)
+        return null;
+    return { owner: path.slice(0, idx), repo: path.slice(idx + 1) };
+}
+/**
+ * Resolve a GitLab issue reference from raw user input into the canonical
+ * `group/sub/project#iid` external id. Accepts:
+ *   - a full issue URL: `https://gitlab.example.com/acme/sub/web/-/issues/123`
+ *   - the `acme/sub/web/-/issues/123` path form
+ *   - the shorthand `acme/sub/web#123`
+ * Returns null when nothing parses. Path segments are kept verbatim (a GitLab path is
+ * case-sensitive in a way GitHub's is not); only surrounding whitespace is trimmed.
+ *
+ * The URL form matches the `/-/issues/` separator GitLab puts between a project path and a
+ * resource, which is also what makes an arbitrarily deep project path unambiguous: without
+ * it there would be no way to tell where the path ends and `issues/123` begins.
+ */
+export function parseGitLabIssueRef(input) {
+    const trimmed = input.trim();
+    const url = trimmed.match(new RegExp(`^https?://[^/]+/(${PROJECT_PATH})/-/issues/(\\d+)`));
+    if (url)
+        return `${url[1]}#${url[2]}`;
+    const path = trimmed.match(new RegExp(`^(${PROJECT_PATH})/-/issues/(\\d+)$`));
+    if (path)
+        return `${path[1]}#${path[2]}`;
+    const short = trimmed.match(new RegExp(`^(${PROJECT_PATH})#(\\d+)$`));
+    if (short)
+        return `${short[1]}#${short[2]}`;
+    return null;
+}
+/**
+ * Split a stored `group/sub/project#iid` external id back into its parts. Returns null if
+ * the id is malformed (defensive — ids are produced by {@link parseGitLabIssueRef}, but a
+ * stale or hand-edited row should not throw).
+ */
+export function parseGitLabIssueExternalId(externalId) {
+    const m = externalId.match(new RegExp(`^(${PROJECT_PATH})#(\\d+)$`));
+    if (!m)
+        return null;
+    const parts = splitProjectPath(m[1]);
+    if (!parts)
+        return null;
+    return { owner: parts.owner, repo: parts.repo, number: Number(m[2]) };
+}
+/**
+ * Build an issue's web URL from the deployment's GitLab web base, for the one case where the
+ * API answered without a `web_url` of its own.
+ *
+ * There is deliberately no constant fallback: a self-managed GitLab lives at the
+ * deployment's own host, so `gitlab.com` would not be a guess that is usually right, it
+ * would be a link to a stranger's instance. `undefined` in, `''` out — an empty URL renders
+ * as no link, where a wrong one renders as a link to the wrong issue.
+ */
+export function gitlabIssueUrl(id, webBaseUrl) {
+    const base = webBaseUrl?.replace(/\/+$/, '');
+    if (!base)
+        return '';
+    return `${base}/${id.owner}/${id.repo}/-/issues/${id.number}`;
+}
+/**
+ * Derive the GitLab WEB base from the configured API base, which is the same host with the
+ * REST prefix on the end (`https://gitlab.example.com/api/v4`). Returns undefined for an
+ * absent/unparseable value rather than a guess, so {@link gitlabIssueUrl} withholds its link.
+ */
+export function gitlabWebBaseFromApiBase(apiBase) {
+    const trimmed = apiBase?.trim().replace(/\/+$/, '');
+    if (!trimmed)
+        return undefined;
+    const stripped = trimmed.replace(/\/api\/v\d+$/, '');
+    return stripped || undefined;
+}
+/**
+ * The provider's `TaskRepoScopeRules` matcher: whether a STORED external id belongs to the
+ * scoped project.
+ *
+ * Case-SENSITIVE, where the GitHub twin is not, and that asymmetry is the whole reason the
+ * comparison belongs to the source rather than to a shared helper. A GitLab project path is the
+ * `path_with_namespace` both sides are built from (the id is parsed out of a `web_url`, the scope
+ * comes from the repo projection's own fold of the same field), so they already agree; folding
+ * case on top would let `Acme/web` and `acme/web`, which GitLab serves as two different projects,
+ * answer for each other.
+ *
+ * An id that does not parse is out of scope, same reading as the GitHub matcher's.
+ */
+export function gitlabIssueInRepoScope(externalId, scope) {
+    const id = parseGitLabIssueExternalId(externalId);
+    return !!id && id.owner === scope.owner && id.repo === scope.repo;
+}
+/**
+ * Build the project-scoped issue search for the picker's free-text box. The scope is the
+ * repository the searching service frame is linked to, and it is an ARGUMENT of the request
+ * rather than text in the query, so there is no unscoped spelling of this search to reach by
+ * accident — see the kernel port's note on why GitLab in particular cannot express the scope
+ * as a qualifier.
+ *
+ * Both states are searched, not just open ones: a picker attaches an issue for CONTEXT, and
+ * a closed issue is routinely the one a follow-up task points at. (The intake/hunt reads,
+ * which pick work to START, are the ones that set `openOnly`.)
+ */
+export function buildGitLabIssueSearchQuery(query, limit) {
+    const text = query.trim();
+    return { limit, ...(text ? { text } : {}) };
+}
+/**
+ * Resolve raw search input that names ONE specific issue in the SCOPED project (rather than
+ * free text) into its canonical external id, so the caller can fetch it and offer it as the
+ * exact match. Two forms, mirroring the GitHub logic's:
+ *   1. An explicit reference (issue URL, `/-/issues/` path, or `group/project#n` shorthand),
+ *      accepted only when it names the SCOPED project.
+ *   2. A bare issue number, resolved against `scope` — the only way to know which project a
+ *      lone number belongs to.
+ * Returns null when the input is neither (treat it as free-text search).
+ *
+ * A reference naming a DIFFERENT project resolves to null on purpose: a search returns the
+ * service's own project and nothing else, so a stray paste can never be dressed up as a hit
+ * the search found. Linking that issue is still supported through the picker's explicit
+ * attach-by-reference row, which imports the ref directly.
+ *
+ * Unlike the GitHub twin the comparison is case-SENSITIVE, and the id is echoed from the
+ * scope for the same reason that one is: GitLab project paths are lowercase by construction
+ * but their display forms are not, and an external id is stored verbatim, so normalising
+ * here is what stops one issue becoming two rows.
+ */
+export function detectExactGitLabIssueRef(query, scope) {
+    const trimmed = query.trim();
+    const ref = parseGitLabIssueRef(trimmed);
+    if (ref) {
+        const id = parseGitLabIssueExternalId(ref);
+        if (!id || id.owner !== scope.owner || id.repo !== scope.repo)
+            return null;
+        return gitlabIssueExternalId({ owner: scope.owner, repo: scope.repo, number: id.number });
+    }
+    if (/^\d+$/.test(trimmed)) {
+        return gitlabIssueExternalId({
+            owner: scope.owner,
+            repo: scope.repo,
+            number: Number(trimmed),
+        });
+    }
+    return null;
+}
+//# sourceMappingURL=gitlab-issues.logic.js.map

package/dist/modules/tasks/gitlab-issues.logic.js.map

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

package/dist/modules/tasks/tasks.logic.d.ts

@@ -10,15 +10,21 @@ export declare class MapTaskSourceRegistry extends MapSourceRegistry<TaskSourceK
 /** A short plain-text excerpt of an issue: its summary + the start of its description. */
 export declare function buildTaskExcerpt(content: TaskContent | TaskRecord, max?: number): string;
 /**
- * Whether an imported task belongs to a repo scope. Only GitHub issues carry a
- * repo (their `owner/repo#number` external id), so a repo-less source (Jira,
- * Linear) always passes — the scope narrows the GitHub view without hiding
- * trackers that have no repo notion. Matching is case-insensitive (GitHub
- * owner/repo names are), mirroring the `repo:owner/name` search qualifier. A
- * GitHub id that doesn't parse (a stale/hand-edited row) is treated as
- * out-of-scope rather than leaking into every repo's list.
+ * Whether an imported task belongs to a repo scope, asked of the source that minted its
+ * external id: a repo-backed provider (GitHub Issues, GitLab Issues) declares `repoScope` and
+ * owns the comparison, because the id GRAMMAR and its case rules are the source's own.
+ *
+ * A source with no `repoScope` passes unfiltered, and that covers two different situations that
+ * happen to want the same answer. A repo-LESS source (Jira, Linear) has no repository to be
+ * narrowed to, so the scope simply does not apply to its rows. An UNREGISTERED source (a row
+ * left behind by a provider this deployment no longer wires) has no rule available to judge it
+ * by, and dropping a row a scope cannot evaluate would silently shrink the list rather than
+ * narrow it: the reader would read the absence as "this service has no such issue".
+ *
+ * Passing the provider rather than looking it up here keeps this pure, and lets the caller
+ * resolve each source ONCE for a whole list instead of per row.
  */
-export declare function taskInRepoScope(record: Pick<TaskRecord, 'source' | 'externalId'>, scope: TaskSearchRepoScope): boolean;
+export declare function taskInRepoScope(record: Pick<TaskRecord, 'source' | 'externalId'>, scope: TaskSearchRepoScope, provider: TaskSourceProvider | undefined): boolean;
 /**
  * Read a numeric HTTP status off a thrown error, if it carries one. Both the
  * GitHub (`GitHubApiError`) and Jira (`JiraApiError`) clients expose a `status`

package/dist/modules/tasks/tasks.logic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/tasks/tasks.logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC9F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAgC,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAGrF,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAQvD,4EAA4E;AAC5E,qBAAa,qBACX,SAAQ,iBAAiB,CAAC,cAAc,EAAE,kBAAkB,CAC5D,YAAW,kBAAkB;CAAG;AAElC,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,EAAE,GAAG,SAAM,GAAG,MAAM,CAIrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,YAAY,CAAC,EACjD,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAQT;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAMxD"}
+{"version":3,"file":"tasks.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/tasks/tasks.logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC9F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAgC,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAErF,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAQvD,4EAA4E;AAC5E,qBAAa,qBACX,SAAQ,iBAAiB,CAAC,cAAc,EAAE,kBAAkB,CAC5D,YAAW,kBAAkB;CAAG;AAElC,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,EAAE,GAAG,SAAM,GAAG,MAAM,CAIrF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,YAAY,CAAC,EACjD,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GACvC,OAAO,CAIT;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAMxD"}

package/dist/modules/tasks/tasks.logic.js

@@ -1,5 +1,4 @@
 import { markdownToText, buildExcerpt, MapSourceRegistry } from '@cat-factory/kernel';
-import { parseGitHubIssueExternalId } from './github-issues.logic.js';
 export { renderTaskContext } from '@cat-factory/kernel';
 // Source-agnostic helpers shared by every task source: a trivial provider
 // registry, deriving a plain-text excerpt from an issue, and rendering an issue
@@ -16,22 +15,25 @@ export function buildTaskExcerpt(content, max = 280) {
     return buildExcerpt(lead, max);
 }
 /**
- * Whether an imported task belongs to a repo scope. Only GitHub issues carry a
- * repo (their `owner/repo#number` external id), so a repo-less source (Jira,
- * Linear) always passes — the scope narrows the GitHub view without hiding
- * trackers that have no repo notion. Matching is case-insensitive (GitHub
- * owner/repo names are), mirroring the `repo:owner/name` search qualifier. A
- * GitHub id that doesn't parse (a stale/hand-edited row) is treated as
- * out-of-scope rather than leaking into every repo's list.
+ * Whether an imported task belongs to a repo scope, asked of the source that minted its
+ * external id: a repo-backed provider (GitHub Issues, GitLab Issues) declares `repoScope` and
+ * owns the comparison, because the id GRAMMAR and its case rules are the source's own.
+ *
+ * A source with no `repoScope` passes unfiltered, and that covers two different situations that
+ * happen to want the same answer. A repo-LESS source (Jira, Linear) has no repository to be
+ * narrowed to, so the scope simply does not apply to its rows. An UNREGISTERED source (a row
+ * left behind by a provider this deployment no longer wires) has no rule available to judge it
+ * by, and dropping a row a scope cannot evaluate would silently shrink the list rather than
+ * narrow it: the reader would read the absence as "this service has no such issue".
+ *
+ * Passing the provider rather than looking it up here keeps this pure, and lets the caller
+ * resolve each source ONCE for a whole list instead of per row.
  */
-export function taskInRepoScope(record, scope) {
-    if (record.source !== 'github')
+export function taskInRepoScope(record, scope, provider) {
+    const rules = provider?.repoScope;
+    if (!rules)
         return true;
-    const parts = parseGitHubIssueExternalId(record.externalId);
-    if (!parts)
-        return false;
-    return (parts.owner.toLowerCase() === scope.owner.toLowerCase() &&
-        parts.repo.toLowerCase() === scope.repo.toLowerCase());
+    return rules.matches(record.externalId, scope);
 }
 /**
  * Read a numeric HTTP status off a thrown error, if it carries one. Both the

package/dist/modules/tasks/tasks.logic.js.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.logic.js","sourceRoot":"","sources":["../../../src/modules/tasks/tasks.logic.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAA;AAGrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD,0EAA0E;AAC1E,gFAAgF;AAChF,kFAAkF;AAClF,yEAAyE;AACzE,sEAAsE;AAEtE,4EAA4E;AAC5E,MAAM,OAAO,qBACX,SAAQ,iBAAqD;CAC7B;AAElC,0FAA0F;AAC1F,MAAM,UAAU,gBAAgB,CAAC,OAAiC,EAAE,GAAG,GAAG,GAAG;IAC3E,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IACvD,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,MAAM,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAA;IAC9E,OAAO,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AAChC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAiD,EACjD,KAA0B;IAE1B,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC3C,MAAM,KAAK,GAAG,0BAA0B,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IAC3D,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACxB,OAAO,CACL,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE;QACvD,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CACtD,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,QAAQ,IAAI,GAAG,EAAE,CAAC;QACtD,MAAM,MAAM,GAAI,GAA2B,CAAC,MAAM,CAAA;QAClD,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAA;IAC/C,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}
+{"version":3,"file":"tasks.logic.js","sourceRoot":"","sources":["../../../src/modules/tasks/tasks.logic.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAGrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD,0EAA0E;AAC1E,gFAAgF;AAChF,kFAAkF;AAClF,yEAAyE;AACzE,sEAAsE;AAEtE,4EAA4E;AAC5E,MAAM,OAAO,qBACX,SAAQ,iBAAqD;CAC7B;AAElC,0FAA0F;AAC1F,MAAM,UAAU,gBAAgB,CAAC,OAAiC,EAAE,GAAG,GAAG,GAAG;IAC3E,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IACvD,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,MAAM,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAA;IAC9E,OAAO,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AAChC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAiD,EACjD,KAA0B,EAC1B,QAAwC;IAExC,MAAM,KAAK,GAAG,QAAQ,EAAE,SAAS,CAAA;IACjC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IACvB,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,QAAQ,IAAI,GAAG,EAAE,CAAC;QACtD,MAAM,MAAM,GAAI,GAA2B,CAAC,MAAM,CAAA;QAClD,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAA;IAC/C,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/integrations",
-  "version": "0.141.2",
+  "version": "0.142.0",
   "description": "External-system integration domain logic for the Agent Architecture Board (GitHub, documents, tasks, environments, runners).",
   "repository": {
     "type": "git",
@@ -27,15 +27,15 @@
     "ai": "^7.0.51",
     "p-map": "^7.0.6",
     "yaml": "^2.9.0",
-    "@cat-factory/kernel": "0.262.2",
-    "@cat-factory/contracts": "0.264.0"
+    "@cat-factory/contracts": "0.265.0",
+    "@cat-factory/kernel": "0.263.0"
   },
   "devDependencies": {
     "typescript": "7.0.2",
     "undici": "^8.10.0",
     "valibot": "^1.4.2",
     "vitest": "^4.1.10",
-    "@cat-factory/caching": "0.18.3"
+    "@cat-factory/caching": "0.18.4"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",