@gitkraken/agent-tools 0.0.0-stage → 0.1.1

package/dist/mcp/jsonc-edit.js

@@ -0,0 +1,3 @@
+import{applyEdits as e,findNodeAtLocation as t,getNodeValue as n,modify as r,parseTree as i,visit as a}from"jsonc-parser";const o={tabSize:2,insertSpaces:!0,eol:`
+`},s={allowTrailingComma:!0};function c(e){return e.startsWith(``)?{bom:``,body:e.slice(1)}:{bom:``,body:e}}function l(e){let t=[];return i(c(e).body,t,s),t.length===0}function u(e,t){if(!l(e))throw Error(`invalid JSON in ${t}`)}function d(e){return e?e.split(`/`).slice(1).map(e=>e.replace(/~1/g,`/`).replace(/~0/g,`~`)):[]}function f(e,n){let r=[],i=e;for(let e of n){let n=i?.type===`array`&&/^(0|[1-9]\d*)$/.test(e)?Number(e):e;r.push(n),i=i?t(i,[n]):void 0}return r}function p(e,r){let a=[],o=i(c(e).body,a,s);if(!o||a.length>0)return;let l=t(o,f(o,d(r)));return l?n(l):void 0}function m(n,a,s,l){u(n,l);let{bom:p,body:m}=c(n),h=d(a),g=m;for(let n=1;n<h.length;n++){let a=i(g),s=a?f(a,h.slice(0,n)):h.slice(0,n);a&&t(a,s)||(g=e(g,r(g,s,{},{formattingOptions:o})))}let _=i(g),v=_?f(_,h):h;return p+e(g,r(g,v,s,{formattingOptions:o}))}function h(n,a){let c=i(n,void 0,s),l=c?f(c,a):a,u=c?t(c,l):void 0;if(!(a.length===0||!c||!u))return u.parent?.type===`array`&&typeof l.at(-1)==`number`?g(n,u.parent,u):v(e(n,r(n,l,void 0,{formattingOptions:o})))}function g(t,n,r){let i=n.children??[],a=i.indexOf(r),o=[{offset:r.offset,length:r.length,content:``}];if(a<i.length-1){let e=_(t,r.offset+r.length,i[a+1].offset);e!==void 0&&o.push({offset:e,length:1,content:``})}else if(a>0){let e=i[a-1],n=_(t,e.offset+e.length,r.offset);n!==void 0&&o.push({offset:n,length:1,content:``})}else{let e=_(t,r.offset+r.length,n.offset+n.length-1);e!==void 0&&o.push({offset:e,length:1,content:``})}return e(t,o.sort((e,t)=>e.offset-t.offset))}function _(e,t,n){for(let r=t;r<n;r++)if(e.startsWith(`//`,r))for(;r<n&&e[r]!==`
+`;)r++;else if(e.startsWith(`/*`,r)){let t=e.indexOf(`*/`,r+2);if(t<0||t>=n)return;r=t+1}else if(e[r]===`,`)return r}function v(e){let t={justOpened:!1},n=()=>{t.justOpened=!1};a(e,{onObjectBegin:()=>{t.justOpened=!0},onSeparator:(e,r)=>{t.justOpened&&e===`,`&&(t.commaOffset??=r),n()},onObjectProperty:n,onObjectEnd:n},s);let{commaOffset:r}=t;return r===void 0?e:e.slice(0,r)+e.slice(r+1)}function y(e,t,n){u(e,n);let{bom:r,body:i}=c(e),a=h(i,d(t));return a===void 0?{text:e,removed:!1}:{text:r+a,removed:!0}}function b(e,t,n){u(e,n);let{bom:r,body:i}=c(e),a=d(t),o=h(i,a);if(o===void 0)return{text:e,removed:!1};let s=a.slice(0,-1);return s.length>0&&x(o,s)&&(o=h(o,s)??o),{text:r+o,removed:!0}}function x(e,n){let r=i(e,void 0,s);if(!r)return!1;let a=t(r,f(r,n));return!a||a.type!==`object`?!1:(a.children?.length??0)===0}export{m as addAtPointer,p as findAtPointer,l as isValidJsonc,y as removeAtPointer,b as removeAtPointerAndEmptyParent};

package/dist/mcp/toml-read.d.ts

@@ -0,0 +1,11 @@
+//#region src/mcp/toml-read.d.ts
+/** Parses TOML `text`, or returns `undefined` on any parse error (mirrors `toml.Unmarshal`'s error check in gkcli). */
+declare function parseTomlSafe(text: string): Record<string, unknown> | undefined;
+/** Throws when `text` isn't valid TOML; `path` names its file in the message. */
+declare function assertValidToml(text: string, path: string): void;
+/** Reads Codex's legacy literal-key table (`['mcp_servers.GitKraken']`), which decodes to a single flat top-level key. */
+declare function tomlLiteralKey(table: Record<string, unknown> | undefined, key: string): unknown;
+/** Walks a dotted key (`a.b.c`) through nested TOML tables. */
+declare function tomlDottedPath(table: Record<string, unknown> | undefined, dottedKey: string): unknown;
+//#endregion
+export { assertValidToml, parseTomlSafe, tomlDottedPath, tomlLiteralKey };

package/dist/mcp/toml-read.js

@@ -0,0 +1 @@
+import{parse as e}from"smol-toml";function t(t){try{return e(t)}catch{return}}function n(e,n){if(!t(e))throw Error(`invalid TOML in ${n}`)}function r(e,t){return e?e[t]:void 0}function i(e,t){let n=e;for(let e of t.split(`.`))if(typeof n!=`object`||!n||Array.isArray(n)||(n=n[e],n===void 0))return;return n}export{n as assertValidToml,t as parseTomlSafe,i as tomlDottedPath,r as tomlLiteralKey};

package/dist/mcp/toml-safety.d.ts

@@ -0,0 +1,7 @@
+//#region src/mcp/toml-safety.d.ts
+/** Removes Codex's entry from a parsed document and gives an absent parent the same shape as an empty table. */
+declare function withoutCodexEntry(table: Record<string, unknown> | undefined): Record<string, unknown>;
+/** Compares parsed TOML values without treating distinct Date values as equal empty objects. */
+declare function tomlSemanticEqual(a: unknown, b: unknown): boolean;
+//#endregion
+export { tomlSemanticEqual, withoutCodexEntry };

package/dist/mcp/toml-safety.js

@@ -0,0 +1 @@
+function e(e){let t={...e??{}};delete t[`mcp_servers.GitKraken`];let r=t.mcp_servers;if(n(r)){let e={...r};delete e.GitKraken,t.mcp_servers=e}else r===void 0&&(t.mcp_servers={});return t}function t(e,n){if(e===n)return!0;if(typeof e!=typeof n||e===null||n===null||typeof e!=`object`)return!1;if(e instanceof Date||n instanceof Date)return e instanceof Date&&n instanceof Date&&e.valueOf()===n.valueOf();if(Array.isArray(e)||Array.isArray(n))return Array.isArray(e)&&Array.isArray(n)&&e.length===n.length&&e.every((e,r)=>t(e,n[r]));let r=e,i=n,a=Object.keys(r);return a.length===Object.keys(i).length&&a.every(e=>e in i&&t(r[e],i[e]))}function n(e){return typeof e==`object`&&!!e&&!Array.isArray(e)&&!(e instanceof Date)}export{t as tomlSemanticEqual,e as withoutCodexEntry};

package/dist/mcp/toml-splice.d.ts

@@ -0,0 +1,16 @@
+//#region src/mcp/toml-splice.d.ts
+/**
+ * Splices `block` over the existing `[tableName]` block (replacing only the
+ * leaf, preserving any `[tableName.*]` subtables) or appends it. `block` must
+ * start with its own header line.
+ */
+declare function replaceOrAppendBlock(original: string, tableName: string, block: string): string;
+/** Removes every `[tableName]` block and any `[tableName.*]` subtables, so hand-added subtables don't become orphans. */
+declare function removeBlock(original: string, tableName: string): {
+  text: string;
+  removed: boolean;
+};
+/** Collapses trailing blank lines to a single newline, so removing an end-of-file block doesn't leave an extra blank line behind. */
+declare function trimTrailingBlankLines(text: string): string;
+//#endregion
+export { removeBlock, replaceOrAppendBlock, trimTrailingBlankLines };

package/dist/mcp/toml-splice.js

@@ -0,0 +1,11 @@
+import{parse as e}from"smol-toml";function t(e,t,n){let{bom:c,body:l}=r(e),u=i(l),d=a(o(n),u)+u,f=s(l,t,!1);if(f.length===0)return w(c,l,d,u);let p=c,m=0;return f.forEach((e,t)=>{p+=l.slice(m,e.start),t===0&&(p+=d),m=e.end}),p+=l.slice(m),p}function n(e,t){let{bom:n,body:i}=r(e),a=s(i,t,!0);if(a.length===0)return{text:e,removed:!1};let o=``,c=0;for(let e of a)o+=i.slice(c,e.start),c=e.end;return o+=i.slice(c),o.length===0?{text:``,removed:!0}:{text:n+o,removed:!0}}function r(e){return e.startsWith(``)?{bom:``,body:e.slice(1)}:{bom:``,body:e}}function i(e){return e.includes(`\r
+`)?`\r
+`:`
+`}function a(e,t){let n=e.replace(/\r\n/g,`
+`);return t===`\r
+`?n.replace(/\n/g,`\r
+`):n}function o(e){return e.replace(/[\r\n]+$/,``)}function s(e,t,n){let r=y(e);if(r.length===0)return[];let i=d(t),{headerKey:a,isHeader:o,lineStartsInString:s}=l(r),u=[],f=-1,_=e=>{if(f<0)return;let t=e;for(;t>f+1&&b(r[t-1]);)t--;u.push({start:c(r,f),end:c(r,t)}),f=-1};for(let e=0;e<r.length;e++){if(s[e]||!o[e])continue;let r=a[e],c=p(r.segments,i)||m(r.segments,t),l=n&&(h(r.segments,i)||g(r.segments,t));if(f>=0){if(c||l){!n&&c&&(_(e),f=e);continue}_(e)}(c||l)&&(f=e)}return _(r.length),u}function c(e,t){let n=0;for(let r=0;r<t&&r<e.length;r++)n+=e[r].length;return n}function l(e){let t=Array(e.length).fill({segments:[]}),n=Array(e.length).fill(!1),r=Array(e.length).fill(!1),i=new x;for(let a=0;a<e.length;a++){if(r[a]=i.inString(),!r[a]){let r=u(e[a]);r!==void 0&&(t[a]=r,n[a]=!0)}i.advance(v(e[a]))}return{headerKey:t,isHeader:n,lineStartsInString:r}}function u(t){let n=v(t).trim();if(!n.startsWith(`[`))return;let r=_(n);if(!(r<0)&&!(n.startsWith(`[[`)&&!n.slice(r+1).startsWith(`]`)))try{return{segments:f(e(`${n}\n`))}}catch{return}}function d(t){try{return f(e(`[${t}]\n`))}catch{return t.split(`.`)}}function f(e){let t=[],n=e;for(;n&&typeof n==`object`&&!Array.isArray(n);){let e=Object.entries(n);if(e.length!==1)break;let[r,i]=e[0];if(t.push(r),n=Array.isArray(i)?i[i.length-1]:i,n&&typeof n==`object`&&!Array.isArray(n)&&Object.keys(n).length===0)break}return t}function p(e,t){return e.length===t.length&&e.every((e,n)=>e===t[n])}function m(e,t){return e.length===1&&e[0]===t}function h(e,t){return e.length>t.length&&t.every((t,n)=>e[n]===t)}function g(e,t){return e.length>1&&e[0]===t}function _(e){let t=!1,n=!1;for(let r=0;r<e.length;r++){let i=e[r];if(t)i===`'`&&(t=!1);else if(n)i===`\\`?r++:i===`"`&&(n=!1);else if(i===`'`)t=!0;else if(i===`"`)n=!0;else if(i===`]`)return r}return-1}function v(e){return e.replace(/\r?\n$/,``)}function y(e){if(e.length===0)return[];let t=[],n=0;for(let r=0;r<e.length;r++)e[r]===`
+`&&(t.push(e.slice(n,r+1)),n=r+1);return n<e.length&&t.push(e.slice(n)),t}function b(e){let t=v(e).trim();return t===``||t.startsWith(`#`)}var x=class{inMultiBasic=!1;inMultiLiteral=!1;inString(){return this.inMultiBasic||this.inMultiLiteral}advance(e){let t=0;for(;t<e.length;)if(this.inMultiBasic){if(e[t]===`\\`&&t+1<e.length){t+=2;continue}if(e.startsWith(`"""`,t)){this.inMultiBasic=!1,t+=3;continue}t++}else if(this.inMultiLiteral){if(e.startsWith(`'''`,t)){this.inMultiLiteral=!1,t+=3;continue}t++}else if(e[t]===`#`)return;else e.startsWith(`"""`,t)?(this.inMultiBasic=!0,t+=3):e.startsWith(`'''`,t)?(this.inMultiLiteral=!0,t+=3):e[t]===`"`?t=S(e,t+1):e[t]===`'`?t=C(e,t+1):t++}};function S(e,t){let n=t;for(;n<e.length;){if(e[n]===`\\`&&n+1<e.length){n+=2;continue}if(e[n]===`"`)return n+1;n++}return n}function C(e,t){let n=t;for(;n<e.length;){if(e[n]===`'`)return n+1;n++}return n}function w(e,t,n,r){let i=e+t;return t.length===0?i+n:(t.endsWith(`
+`)||(i+=r),T(t)||(i+=r),i+n)}function T(e){if(!e.endsWith(`
+`))return!1;let t=e.slice(0,-1);return t.endsWith(`\r`)&&(t=t.slice(0,-1)),t.endsWith(`
+`)}function E(e){let t=e.replace(/[ \t\r\n]+$/,``);return t===``?``:`${t}\n`}export{n as removeBlock,t as replaceOrAppendBlock,E as trimTrailingBlankLines};

package/dist/mcp/uninstaller.d.ts

@@ -0,0 +1,41 @@
+import { AgentHostConfig } from "../config.js";
+import { Client } from "./clients.js";
+
+//#region src/mcp/uninstaller.d.ts
+interface McpUninstallRequest {
+  client: Client;
+  /**
+   * Clears this path instead of every path {@link clientConfigPaths} resolves
+   * (Go's `--file-path`). When set, only this one file is touched — e.g. the
+   * antigravity legacy path is not additionally swept.
+   */
+  configPath?: string;
+}
+interface McpUninstallFileResult {
+  path: string;
+  /** MCP uninstall edits a config file but never deletes it. */
+  change: 'updated' | 'unchanged';
+  /** The pointers or table keys removed from this file. */
+  removedLocations: string[];
+  /** Why nothing was removed; set when `change` is `unchanged`. */
+  reason?: 'file-missing' | 'file-empty' | 'no-entry';
+}
+interface McpUninstallResult {
+  client: Client;
+  /** Whether a GitKraken entry was actually removed from at least one config path. */
+  removed: boolean;
+  /** One entry per path swept, in sweep order. */
+  files: McpUninstallFileResult[];
+}
+/**
+ * Clears the client's GitKraken MCP entry from every config path it may live
+ * in (mirrors gkcli's uninstall sweep across `mcp.Client.Paths()`), including
+ * OpenCode's v1/v2 pointer pair and Codex's comment-preserving TOML splice.
+ * A missing or empty config is a no-op, matching Go's "already uninstalled".
+ *
+ * Throws, before writing anything, for an unknown client or a config file that
+ * does not parse, so a sweep never leaves some files edited and others not.
+ */
+declare function uninstallMcp(request: McpUninstallRequest, config: AgentHostConfig): Promise<McpUninstallResult>;
+//#endregion
+export { McpUninstallFileResult, McpUninstallRequest, McpUninstallResult, uninstallMcp };

package/dist/mcp/uninstaller.js

@@ -0,0 +1 @@
+import{removeAtPointer as e,removeAtPointerAndEmptyParent as t}from"./jsonc-edit.js";import{assertValidToml as n,parseTomlSafe as r,tomlDottedPath as i,tomlLiteralKey as a}from"./toml-read.js";import{OPEN_CODE_JSON_PATHS as o,clientConfigPaths as s,clientJSONPath as c,isSupported as l}from"./clients.js";import{writeFileTracked as u}from"../file-change.js";import{tomlSemanticEqual as d,withoutCodexEntry as f}from"./toml-safety.js";import{removeBlock as p,trimTrailingBlankLines as m}from"./toml-splice.js";function h(e,t){return{file:{path:e,change:`unchanged`,removedLocations:[],reason:t}}}async function g(e,t){let{client:n}=e;if(!l(n))throw Error(`unsupported client: ${n}`);let r=e.configPath?[e.configPath]:await s(n,t),i=[];for(let e of r)i.push(await _(n,e,t));let a=[];for(let{file:e,text:n}of i)n!==void 0&&await u(t.fs,e.path,n,[]),a.push(e);return{client:n,removed:a.some(e=>e.removedLocations.length>0),files:a}}async function _(e,t,n){let r=await n.fs.readFile(t);if(r===null)return h(t,`file-missing`);if(r.trim()===``)return h(t,`file-empty`);let{text:i,removedLocations:a}=e===`codex`?y(r,t):v(r,e,t);return a.length===0?h(t,`no-entry`):{file:{path:t,change:`updated`,removedLocations:a},text:i}}function v(n,r,i){let a=r===`opencode`,s=a?o:[c(r)],l=n,u=[];for(let n of s){let r=a?t(l,n,i):e(l,n,i);r.removed&&(l=r.text,u.push(n))}return{text:l,removedLocations:u}}function y(e,t){n(e,t);let o=c(`codex`),s=r(e);if(a(s,o)===void 0&&i(s,o)===void 0)return{text:e,removedLocations:[]};let{text:l,removed:u}=p(e,o);if(!u){if(a(s,o)!==void 0||i(s,o)!==void 0)throw Error(`cannot safely remove Codex MCP entry in ${t}: unsupported TOML representation`);return{text:e,removedLocations:[]}}let h=m(l),g=r(h);if(a(g,o)!==void 0||i(g,o)!==void 0)throw Error(`cannot safely remove Codex MCP entry in ${t}: target remains after splice`);if(!g||!d(f(g),f(s)))throw Error(`cannot safely remove Codex MCP entry in ${t}: splice would change another TOML value`);return{text:h,removedLocations:[o]}}export{g as uninstallMcp};

package/dist/skills/index.d.ts

@@ -0,0 +1,4 @@
+import { SKILL_MANIFEST_FILE_NAME, SKILL_MANIFEST_SCHEMA_VERSION, SkillManifest } from "./manifest.js";
+import { SkillAgent, allSkillAgents, isSkillAgentSupported, skillDir } from "./skill-dirs.js";
+import { SkillConflictError, SkillFiles, SkillInstallAction, SkillInstallOptions, SkillInstallResult, SkillOperation, SkillReason, SkillState, SkillStatus, SkillUninstallAction, SkillUninstallOptions, SkillUninstallResult, SkillUnsupportedManifestError, inspectSkillStatus, installSkill, uninstallSkill } from "./install.js";
+export { SKILL_MANIFEST_FILE_NAME, SKILL_MANIFEST_SCHEMA_VERSION, type SkillAgent, SkillConflictError, type SkillFiles, type SkillInstallAction, type SkillInstallOptions, type SkillInstallResult, type SkillManifest, type SkillOperation, type SkillReason, type SkillState, type SkillStatus, type SkillUninstallAction, type SkillUninstallOptions, type SkillUninstallResult, SkillUnsupportedManifestError, allSkillAgents, inspectSkillStatus, installSkill, isSkillAgentSupported, skillDir, uninstallSkill };

package/dist/skills/index.js

@@ -0,0 +1 @@
+import{SKILL_MANIFEST_FILE_NAME as e,SKILL_MANIFEST_SCHEMA_VERSION as t}from"./manifest.js";import{allSkillAgents as n,isSkillAgentSupported as r,skillDir as i}from"./skill-dirs.js";import{SkillConflictError as a,SkillUnsupportedManifestError as o,inspectSkillStatus as s,installSkill as c,uninstallSkill as l}from"./install.js";export{e as SKILL_MANIFEST_FILE_NAME,t as SKILL_MANIFEST_SCHEMA_VERSION,a as SkillConflictError,o as SkillUnsupportedManifestError,n as allSkillAgents,s as inspectSkillStatus,c as installSkill,r as isSkillAgentSupported,i as skillDir,l as uninstallSkill};

package/dist/skills/install.d.ts

@@ -0,0 +1,126 @@
+import { AgentHostConfig } from "../config.js";
+import { FileChange } from "../file-change.js";
+import { SkillManifest } from "./manifest.js";
+import { SkillAgent } from "./skill-dirs.js";
+
+//#region src/skills/install.d.ts
+interface SkillFiles {
+  agent: SkillAgent;
+  /** A nonempty portable directory name (one path segment, not `.`/`..`). */
+  name: string;
+  /** Safe relative slash paths (e.g. `'SKILL.md'`) -> file content. Must be nonempty and exclude the reserved manifest path. */
+  files: Record<string, string>;
+}
+/**
+ * How the skill's on-disk state compares to the bundle passed in. Mirrors
+ * gkcli's `SkillStatus`/`InstallState`/reason constants
+ * (`internal/actions/aiskill/skill.go`), minus the fields this library has no
+ * way to observe: `removalBlocked`'s `symlink` half (no `FileSystemPort`
+ * primitive reports a symlink) and project-scope provenance (`AgentHostConfig`
+ * has no git-worktree concept, so every install/uninstall is Go's "global"
+ * scope).
+ */
+type SkillState = 'missing' | 'current' | 'older-release' | 'modified';
+type SkillReason = 'absent' | 'unowned' | 'invalid-manifest' | 'unsupported-manifest' | 'content-changed' | 'different-bundle' | 'stale-stamp';
+interface SkillStatus {
+  state: SkillState;
+  /** The skill's directory, `<skillDir>/<name>`. */
+  path: string;
+  /** Why the skill is not plainly current or missing. Absent when it is current and clean. */
+  reason?: SkillReason;
+  /** Whether `force` could repair this status — always `false` for `'unsupported-manifest'`. */
+  requiresForce: boolean;
+  /** Whether a valid, matching manifest vouches for this skill (mirrors `SkillStatus.Owned`). */
+  owned: boolean;
+  /** Whether the on-disk files are byte-identical to the bundle passed in. */
+  matchesBundle: boolean;
+  manifestVersion?: number;
+  installedAt?: string;
+  updatedAt?: string;
+}
+/** Inspects the on-disk state against a bundle without writing any files. */
+declare function inspectSkillStatus(request: SkillFiles, config: AgentHostConfig): Promise<SkillStatus>;
+type SkillInstallAction = 'create' | 'replace' | 'unchanged';
+type SkillUninstallAction = 'remove' | 'absent';
+type SkillOperation = 'install' | 'uninstall';
+/** A skill's on-disk content conflicts with the bundle, and `force` was not set (or cannot repair it). */
+declare class SkillConflictError extends Error {
+  readonly code: 'conflict' | 'invalid-manifest' | 'modified';
+  readonly operation: SkillOperation;
+  /** The skill's directory. */
+  readonly path: string;
+  readonly status: SkillStatus;
+  constructor(status: SkillStatus, operation: SkillOperation);
+  private static codeFor;
+  private static buildMessage;
+}
+/** A skill's manifest was written by a newer release. Neither install nor uninstall may discard state this version cannot interpret, even with `force`. */
+declare class SkillUnsupportedManifestError extends Error {
+  readonly code = "unsupported-manifest";
+  readonly operation: SkillOperation;
+  /** The skill's directory. */
+  readonly path: string;
+  readonly status: SkillStatus;
+  constructor(status: SkillStatus, operation: SkillOperation);
+}
+interface SkillInstallOptions {
+  /** Overwrite content this library cannot otherwise prove it owns. Never lifts a `SkillUnsupportedManifestError`. */
+  force?: boolean;
+  /** Recorded as the manifest's `gkVersion`. Defaults to `'dev'`, the value gkcli dev builds record. */
+  version?: string;
+  /** Injectable for tests; defaults to `new Date()`. */
+  now?: Date;
+}
+interface SkillInstallResult {
+  action: SkillInstallAction;
+  /** The skill's status before the action. */
+  status: SkillStatus;
+  /** The skill's directory. */
+  path: string;
+  /** What the install did to each content file and the manifest. Empty when `action` is `'unchanged'` and nothing needed repair. */
+  files: FileChange[];
+  /** The manifest now on disk. Absent when nothing was written. */
+  manifest?: SkillManifest;
+}
+/**
+ * Writes a bundled skill's files under `<skillDir>/<name>/` for `agent`, and
+ * the `.gk-skill.json` ownership manifest beside them. Mirrors gkcli's
+ * `aiskill.Install`: a fresh install (`'create'`), a no-op when the bundle is
+ * already current (`'unchanged'`, still repairing a missing or stale manifest
+ * when applicable), an automatic upgrade over an owned older release
+ * (`'replace'`), and — with `force` — a repair over content this library does not
+ * otherwise recognize. Without `force`, content that conflicts with the
+ * bundle throws {@link SkillConflictError}; a manifest from a newer release
+ * always throws {@link SkillUnsupportedManifestError}. `name` must be one
+ * portable directory segment; `files` must be a nonempty map of safe relative
+ * slash paths without traversal, collisions, or the reserved manifest path.
+ * The result lists each file created, updated or left unchanged.
+ */
+declare function installSkill(request: SkillFiles, config: AgentHostConfig, options?: SkillInstallOptions): Promise<SkillInstallResult>;
+interface SkillUninstallOptions {
+  /** Remove content this library cannot otherwise prove it owns. Never lifts a `SkillUnsupportedManifestError`. */
+  force?: boolean;
+}
+interface SkillUninstallResult {
+  action: SkillUninstallAction;
+  /** The skill's status before the action. */
+  status: SkillStatus;
+  /** The skill's directory. */
+  path: string;
+  /** The content files removed, the manifest when it was owned and removable, and the directory once it was left empty. Empty when `action` is `'absent'`. */
+  files: FileChange[];
+}
+/**
+ * Removes a bundled skill's files for `agent`, mirroring gkcli's
+ * `aiskill.Uninstall`. A skill whose content is byte-identical to the bundle
+ * passed in is always removed; an owned older release is removed without
+ * `force`; other content requires `force`. The manifest is removed alongside
+ * the content only when it is owned (a valid, matching manifest) and either
+ * `force` was set or the content wasn't hand-edited after install (mirrors
+ * `removeSkillFile`'s `removeManifest` rule: a foreign or mismatched-identity
+ * manifest is left in place even though the content beside it is removable).
+ * The skill's directory is removed too, but only once it is left empty.
+ */
+declare function uninstallSkill(request: SkillFiles, config: AgentHostConfig, options?: SkillUninstallOptions): Promise<SkillUninstallResult>;
+//#endregion
+export { SkillConflictError, SkillFiles, SkillInstallAction, SkillInstallOptions, SkillInstallResult, SkillOperation, SkillReason, SkillState, SkillStatus, SkillUninstallAction, SkillUninstallOptions, SkillUninstallResult, SkillUnsupportedManifestError, inspectSkillStatus, installSkill, uninstallSkill };

package/dist/skills/install.js

@@ -0,0 +1 @@
+import{joinPath as e}from"../config.js";import{removeTracked as t,writeFileTracked as n}from"../file-change.js";import{SKILL_MANIFEST_FILE_NAME as r,buildSkillManifest as i,digestFiles as a,readSkillManifest as o,serializeSkillManifest as s}from"./manifest.js";import{skillDir as c}from"./skill-dirs.js";function l(e){let t=e.name;if(typeof t!=`string`||t.length===0||t===`.`||t===`..`||/[\\/:<>"|?*]/.test(t)||u(t)||/[ .]$/.test(t)||/^(con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/i.test(t))throw TypeError(`skill name must be a nonempty portable directory name`);if(typeof e.files!=`object`||e.files===null||Array.isArray(e.files))throw TypeError(`skill files must be a nonempty file map`);let n=Object.keys(e.files);if(n.length===0)throw TypeError(`skill files must be a nonempty file map`);let i=new Set;for(let t of n){if(typeof e.files[t]!=`string`||t.length===0||t.startsWith(`/`)||t.includes(`\\`)||t.includes(`:`)||t.split(`/`).some(e=>e===``||e===`.`||e===`..`||/[<>"|?*]/.test(e)||u(e)||/[ .]$/.test(e)||/^(con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/i.test(e)))throw TypeError(`skill file path must be a safe relative slash path: ${t}`);let n=t.toLowerCase(),a=r.toLowerCase();if(n===a||n.startsWith(`${a}/`))throw TypeError(`skill files cannot include ${r}`);if(i.has(n))throw TypeError(`skill files contain a case-insensitive path collision: ${t}`);i.add(n)}for(let e of i){let t=e.split(`/`);for(let n=1;n<t.length;n++)if(i.has(t.slice(0,n).join(`/`)))throw TypeError(`skill files contain a file and parent path collision: ${e}`)}}function u(e){return[...e].some(e=>e.charCodeAt(0)<32||e.charCodeAt(0)===127)}function d(e){return e!==`unsupported-manifest`}function f(e){return e===`unowned`||e===`stale-stamp`}async function p(t,n,r){let i=Object.create(null);for(let a of n){let n=await r.readFile(e(t,a));n!==null&&(i[a]=n)}return i}async function m(t,n){let r=Object.create(null),i=[],a=async(t,o)=>{let s;try{s=await n.readFile(t)}catch(e){if(e?.code!==`EISDIR`)throw e;s=null}if(s!==null){o!==`.gk-skill.json`&&(r[o]=s);return}let c;try{c=await n.readDir(t)}catch(e){if(e?.code===`ENOENT`&&o===``)return;throw e}if(c!==null){i.push(t);for(let n of c)await a(e(t,n),o?`${o}/${n}`:n)}};return await a(t,``),{files:r,directories:i}}function h(t,n){let r=new Set([t]);for(let i of n){let n=i.split(`/`);for(let i=1;i<n.length;i++)r.add(e(t,n.slice(0,i).join(`/`)))}return[...r]}function g(e,t){let n=Object.keys(e),r=Object.keys(t);return n.length===r.length?n.every(n=>e[n]===t[n]):!1}async function _(t,n){let i=e(c(t.agent,n),t.name),s=e(i,r),l=Object.keys(t.files),{manifest:u,reason:f}=await o(s,t.name,t.agent,`global`,n.fs.readFile.bind(n.fs)),_,v=async()=>(_??=await m(i,n.fs),_),y=(e,t=[])=>({status:e,ownedPaths:t,directories:_?.directories??h(i,t)});if(f===`unsupported-manifest`)return y({state:`modified`,path:i,reason:`unsupported-manifest`,requiresForce:!1,owned:!1,matchesBundle:!1});let b=await p(i,l,n.fs),x=Object.keys(b),S=x.length>0,C=x.length===l.length,w=C&&g(b,t.files);if(!S){if(u===void 0){if(f!==`unowned`){let e=f??`absent`;return y({state:`missing`,path:i,reason:e,requiresForce:d(e),owned:!1,matchesBundle:!1})}return y({state:`missing`,path:i,reason:`absent`,requiresForce:!1,owned:!1,matchesBundle:!1})}let e=await v(),t=Object.keys(e.files);return(t.length>0?await a(e.files):void 0)===u.digest?y({state:`older-release`,path:i,reason:`different-bundle`,requiresForce:!1,owned:!0,matchesBundle:!1,manifestVersion:u.schemaVersion,installedAt:u.installedAt,updatedAt:u.updatedAt},t):t.length>0?y({state:`modified`,path:i,reason:`content-changed`,requiresForce:!0,owned:!0,matchesBundle:!1,manifestVersion:u.schemaVersion,installedAt:u.installedAt,updatedAt:u.updatedAt}):y({state:`missing`,path:i,reason:`absent`,requiresForce:!1,owned:!1,matchesBundle:!1})}if(u===void 0){let e=f??`invalid-manifest`;return e===`unowned`&&w?y({state:`current`,path:i,reason:`unowned`,requiresForce:!1,owned:!1,matchesBundle:w},l):y({state:`modified`,path:i,reason:e,requiresForce:d(e),owned:!1,matchesBundle:w},x)}let T={owned:!0,manifestVersion:u.schemaVersion,installedAt:u.installedAt,updatedAt:u.updatedAt};if((C?await a(b):void 0)===u.digest)return y(w?{state:`current`,path:i,requiresForce:!1,matchesBundle:w,...T}:{state:`older-release`,path:i,reason:`different-bundle`,requiresForce:!1,matchesBundle:w,...T},l);let E=await v(),D=Object.keys(E.files);return(D.length>0?await a(E.files):void 0)===u.digest?y({state:`older-release`,path:i,reason:`different-bundle`,requiresForce:!1,matchesBundle:w,...T},D):w&&g(E.files,t.files)?y({state:`current`,path:i,reason:`stale-stamp`,requiresForce:!1,matchesBundle:w,...T},l):y({state:`modified`,path:i,reason:`content-changed`,requiresForce:d(`content-changed`),matchesBundle:w,...T},x)}async function v(e,t,n,r){for(let i of[...t].sort((e,t)=>t.length-e.length))i!==r&&(await e.readDir(i))?.length===0&&(await e.remove(i),n.push({path:i,change:`removed`}))}async function y(e,t){return l(e),(await _(e,t)).status}function b(e,t){switch(e.state){case`missing`:switch(e.reason){case void 0:case`absent`:case`unowned`:return`create`;default:return t&&d(e.reason)?`replace`:`conflict`}case`current`:return t?`replace`:`unchanged`;case`older-release`:return`replace`;default:return t&&d(e.reason)?`replace`:`conflict`}}function x(e,t){return e.state===`missing`?`absent`:e.reason===`unsupported-manifest`?`unsupported-manifest`:e.matchesBundle||t||e.state===`older-release`?`remove`:`modified`}var S=class e extends Error{code;operation;path;status;constructor(t,n){let r=e.codeFor(t,n);super(e.buildMessage(r,t,n)),this.name=`SkillConflictError`,this.code=r,this.operation=n,this.path=t.path,this.status=t}static codeFor(e,t){return t===`uninstall`?`modified`:e.reason===`invalid-manifest`?`invalid-manifest`:`conflict`}static buildMessage(e,t,n){let r=n===`install`?`replace`:`remove`;return e===`invalid-manifest`?`skill at ${t.path} has invalid ownership metadata; pass \`force\` to ${r} it`:`skill at ${t.path} differs from the bundle (${t.reason}); pass \`force\` to ${r} it`}},C=class extends Error{code=`unsupported-manifest`;operation;path;status;constructor(e,t){super(`skill metadata at ${e.path} was written by a newer release and can't be interpreted; nothing was changed`),this.name=`SkillUnsupportedManifestError`,this.operation=t,this.path=e.path,this.status=e}};async function w(a,o,c={}){l(a);let u=await _(a,o),{status:d}=u,p=b(d,c.force??!1);if(p===`conflict`)throw d.reason===`unsupported-manifest`?new C(d,`install`):new S(d,`install`);let m=d.path,h=e(m,r),g=p===`unchanged`&&f(d.reason);if(p===`unchanged`&&!g)return{action:p,status:d,path:m,files:[]};let y=[];if(!g){for(let[t,r]of Object.entries(a.files))await n(o.fs,e(m,t),r,y,{mode:420});if(d.state===`older-release`){let n=new Set(Object.keys(a.files));for(let r of u.ownedPaths)n.has(r)||await t(o.fs,e(m,r),y);await v(o.fs,u.directories,y,m)}}let x=await i(a.name,a.agent,a.files,d.installedAt,c.version,c.now??new Date);return await n(o.fs,h,s(x),y,{mode:420}),{action:p,status:d,path:m,files:y,manifest:x}}async function T(n,i,a={}){l(n);let o=await _(n,i),{status:s}=o,c=a.force??!1,u=x(s,c);if(u===`unsupported-manifest`)throw new C(s,`uninstall`);if(u===`modified`)throw new S(s,`uninstall`);if(u===`absent`)return{action:u,status:s,path:s.path,files:[]};let d=s.path,f=[];for(let n of o.ownedPaths)await t(i.fs,e(d,n),f);return s.owned&&(c||s.reason!==`content-changed`)&&await t(i.fs,e(d,r),f),await v(i.fs,o.directories,f,void 0),{action:u,status:s,path:d,files:f}}export{S as SkillConflictError,C as SkillUnsupportedManifestError,y as inspectSkillStatus,w as installSkill,T as uninstallSkill};

package/dist/skills/manifest.d.ts

@@ -0,0 +1,56 @@
+//#region src/skills/manifest.d.ts
+/**
+ * The ownership manifest gkcli's `aiskill` package writes beside a skill's
+ * content (`.gk-skill.json`), and the read/validate/digest logic that backs
+ * `installSkill`/`uninstallSkill`'s state machine. Direct port of
+ * `internal/actions/aiskill/manifest.go`.
+ *
+ * This is deliberately local bookkeeping, not a publisher signature: it lets
+ * `installSkill`/`uninstallSkill` tell "gk installed this, byte-identical to
+ * what it wrote" apart from "someone else's file happens to be here."
+ */
+declare const SKILL_MANIFEST_FILE_NAME = ".gk-skill.json";
+declare const SKILL_MANIFEST_SCHEMA_VERSION = 1;
+/** Persisted shape of `.gk-skill.json`. See `## Persisted data` in `ARCHITECTURE.md`. */
+interface SkillManifest {
+  schemaVersion: number;
+  owner: string;
+  skill: string;
+  client: string;
+  scope: string;
+  /** `sha256:<64 lowercase hex chars>`. */
+  digest: string;
+  gkVersion?: string;
+  /** ISO 8601 / RFC 3339. */
+  installedAt?: string;
+  /** ISO 8601 / RFC 3339. */
+  updatedAt?: string;
+}
+/** `sha256:<hex>` of a single string, compatible with gkcli's manifest digest so either tool can verify ownership. */
+declare function digestContent(content: string): Promise<string>;
+/**
+ * `sha256:<hex>` over every file in a skill (sorted by path), for a skill
+ * bundle with more than one file. gkcli's bundled skills are always exactly
+ * one file (`SKILL.md`), where this reduces to {@link digestContent} of that
+ * file's bytes; multi-file skills have no Go equivalent to stay byte-compatible
+ * with.
+ */
+declare function digestFiles(files: Readonly<Record<string, string>>): Promise<string>;
+/** Why a manifest read didn't return a valid, matching manifest — see `SkillReason` in `install.ts`. */
+type ManifestReadReason = 'unowned' | 'invalid-manifest' | 'unsupported-manifest';
+interface ManifestReadResult {
+  manifest?: SkillManifest;
+  /** Set only when `manifest` is `undefined`. */
+  reason?: ManifestReadReason;
+}
+/**
+ * Reads and validates the manifest beside `target`. The host filesystem port
+ * does not expose symlink identity, so symlink handling is the host's
+ * responsibility (see `ARCHITECTURE.md`).
+ */
+declare function readSkillManifest(manifestPath: string, name: string, client: string, scope: string, readFile: (path: string) => Promise<string | null>): Promise<ManifestReadResult>;
+/** Builds the manifest `installSkill` writes. Mirrors `marshalManifest`; `scope` is always `'global'` (see `readSkillManifest`'s doc comment). */
+declare function buildSkillManifest(name: string, client: string, files: Readonly<Record<string, string>>, previousInstalledAt: string | undefined, version: string | undefined, now: Date): Promise<SkillManifest>;
+declare function serializeSkillManifest(manifest: SkillManifest): string;
+//#endregion
+export { ManifestReadReason, ManifestReadResult, SKILL_MANIFEST_FILE_NAME, SKILL_MANIFEST_SCHEMA_VERSION, SkillManifest, buildSkillManifest, digestContent, digestFiles, readSkillManifest, serializeSkillManifest };

package/dist/skills/manifest.js

@@ -0,0 +1 @@
+const e=`.gk-skill.json`,t=1,n=`gitkraken`;async function r(e){let t=new TextEncoder().encode(e),n=await globalThis.crypto.subtle.digest(`SHA-256`,t);return Array.from(new Uint8Array(n)).map(e=>e.toString(16).padStart(2,`0`)).join(``)}async function i(e){return`sha256:${await r(e)}`}async function a(e){let t=Object.keys(e).sort();return t.length===1?i(e[t[0]]):i(t.map(t=>`${t}\u0000${e[t]}`).join(`\0`))}const o=/^sha256:[0-9a-f]{64}$/;function s(e){return typeof e==`string`&&o.test(e)}function c(e){if(typeof e!=`string`)return!1;let t=/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.\d+)?(Z|[+-]\d{2}:\d{2})$/.exec(e);if(!t)return!1;let[,n,r,i,a,o,s,c]=t,l=Number(n),u=Number(r),d=Number(i),f=Number(a),p=Number(o),m=Number(s),h=[31,l%4==0&&(l%100!=0||l%400==0)?29:28,31,30,31,30,31,31,30,31,30,31][u-1];if(u<1||u>12||d<1||d>h||f>23||p>59||m>59)return!1;if(c!==`Z`){let e=/[+-](\d{2}):(\d{2})$/.exec(c);if(!e||Number(e[1])>23||Number(e[2])>59)return!1}return!0}function l(e,t,r,i){return e.schemaVersion!==1||e.owner!==n||e.skill!==t||e.client!==r||e.scope!==i||!s(e.digest)?!1:typeof e.installedAt==`string`&&c(e.installedAt)&&typeof e.updatedAt==`string`&&c(e.updatedAt)&&(e.gkVersion===void 0||typeof e.gkVersion==`string`)}async function u(e,t,n,r,i){let a=await i(e);if(a===null)return{reason:`unowned`};let o;try{o=JSON.parse(a)}catch{return{reason:`invalid-manifest`}}if(typeof o!=`object`||!o)return{reason:`invalid-manifest`};let s=o;return s.schemaVersion===1?l(s,t,n,r)?{manifest:s}:{reason:`invalid-manifest`}:{reason:`unsupported-manifest`}}function d(e){return e.toISOString().replace(/\.\d{3}Z$/,`Z`)}async function f(e,t,r,i,o,s){let c=d(s);return{schemaVersion:1,owner:n,skill:e,client:t,scope:`global`,digest:await a(r),gkVersion:o||`dev`,installedAt:i||c,updatedAt:c}}function p(e){return`${JSON.stringify(e)}\n`}export{e as SKILL_MANIFEST_FILE_NAME,t as SKILL_MANIFEST_SCHEMA_VERSION,f as buildSkillManifest,i as digestContent,a as digestFiles,u as readSkillManifest,p as serializeSkillManifest};

package/dist/skills/skill-dirs.d.ts

@@ -0,0 +1,22 @@
+import { AgentHostConfig } from "../config.js";
+
+//#region src/skills/skill-dirs.d.ts
+/**
+ * Hook-registry client ids gkcli can install bundled skills for (a subset of
+ * the full aihook registry — every client that has a skill install
+ * directory). Ids match gkcli's `aihook.Client` values, which differ from
+ * the MCP registry's (`'claude-code'` here vs. `'claude-cli'` in
+ * `src/mcp`); the two registries are unified only by gkcli's own
+ * `internal/agents` package, which is out of this lane's P6.1/P6.2 scope.
+ */
+type SkillAgent = 'claude-code' | 'opencode' | 'cursor' | 'codex' | 'copilot' | 'antigravity' | 'pi' | 'augment' | 'grok';
+declare function allSkillAgents(): SkillAgent[];
+declare function isSkillAgentSupported(agent: string): agent is SkillAgent;
+/**
+ * The global skill install directory for `agent` (bundled skills are written
+ * one subdirectory per skill name beneath it). Direct port of gkcli's
+ * `aiskill.skillDirs`.
+ */
+declare function skillDir(agent: SkillAgent, config: AgentHostConfig): string;
+//#endregion
+export { SkillAgent, allSkillAgents, isSkillAgentSupported, skillDir };

package/dist/skills/skill-dirs.js

@@ -0,0 +1 @@
+import{joinPath as e}from"../config.js";const t=[`claude-code`,`opencode`,`cursor`,`codex`,`copilot`,`antigravity`,`pi`,`augment`,`grok`];function n(){return[...t]}function r(e){return t.includes(e)}function i(t){return t.paths.piAgentDir||e(t.paths.home,`.pi`,`agent`)}function a(t){return t.paths.grokHome||e(t.paths.home,`.grok`)}function o(t,n){switch(t){case`claude-code`:return n.paths.claudeConfigDir?e(n.paths.claudeConfigDir,`skills`):e(n.paths.home,`.claude`,`skills`);case`opencode`:return e(n.paths.configHome,`opencode`,`skills`);case`cursor`:return e(n.paths.home,`.cursor`,`skills`);case`codex`:return e(n.paths.home,`.agents`,`skills`);case`copilot`:return n.paths.copilotHome?e(n.paths.copilotHome,`skills`):e(n.paths.home,`.copilot`,`skills`);case`antigravity`:return e(n.paths.home,`.gemini`,`config`,`skills`);case`pi`:return e(i(n),`skills`);case`augment`:return e(n.paths.home,`.augment`,`skills`);case`grok`:return e(a(n),`skills`);default:throw Error(`"${t}" is not a supported client`)}}export{n as allSkillAgents,r as isSkillAgentSupported,o as skillDir};

package/dist/testing/index.d.ts

@@ -0,0 +1,2 @@
+import { MemoryFileSystem } from "./memory-fs.js";
+export { MemoryFileSystem };

package/dist/testing/index.js

@@ -0,0 +1 @@
+import{MemoryFileSystem as e}from"./memory-fs.js";export{e as MemoryFileSystem};

package/dist/testing/memory-fs.d.ts

@@ -0,0 +1,22 @@
+import { FileSystemPort } from "@gitkraken/shared-tools";
+
+//#region src/testing/memory-fs.d.ts
+/** In-memory {@link FileSystemPort}, for a host's own tests driving `installMcp`/`installSkill` and friends without touching a real filesystem. */
+declare class MemoryFileSystem implements FileSystemPort {
+  private readonly files;
+  private readonly directories;
+  constructor(seed?: Record<string, string>);
+  readFile(path: string): Promise<string | null>;
+  writeFile(path: string, content: string, _options?: {
+    mode?: number;
+  }): Promise<void>;
+  remove(path: string, options?: {
+    recursive?: boolean;
+  }): Promise<void>;
+  readDir(path: string): Promise<string[] | null>;
+  /** Full path -> content snapshot, for assertions in a host's own tests. Not part of {@link FileSystemPort}. */
+  snapshot(): Record<string, string>;
+  private addParentDirectories;
+}
+//#endregion
+export { MemoryFileSystem };

package/dist/testing/memory-fs.js

@@ -0,0 +1 @@
+var e=class{files=new Map;directories=new Set([`/`]);constructor(e){if(e)for(let[n,r]of Object.entries(e)){let e=t(n);this.files.set(e,r),this.addParentDirectories(e)}}async readFile(e){return this.files.get(t(e))??null}async writeFile(e,n,r){let i=t(e);this.files.set(i,n),this.addParentDirectories(i)}async remove(e,n){let r=t(e),i=`${r}/`;if(this.files.has(r)){this.files.delete(r);return}if(!this.directories.has(r))return;if(!n?.recursive){if((await this.readDir(r))?.length)throw Error(`directory not empty: ${r}`);r!==`/`&&this.directories.delete(r);return}let a=r===`/`?`/`:i;for(let e of this.files.keys())e.startsWith(a)&&this.files.delete(e);for(let e of this.directories)(e===r||e.startsWith(a))&&e!==`/`&&this.directories.delete(e)}async readDir(e){let n=t(e);if(!this.directories.has(n))return null;let r=n===`/`?`/`:`${n}/`,i=new Set;for(let e of[...this.files.keys(),...this.directories])if(e.startsWith(r)){let t=e.slice(r.length);t&&i.add(t.split(`/`)[0])}return[...i]}snapshot(){return Object.fromEntries(this.files)}addParentDirectories(e){for(let t=0;t<e.length-1;t++)e[t]===`/`&&(t===0?this.directories.add(`/`):(t===2&&/^[A-Za-z]:$/.test(e.slice(0,t)),this.directories.add(e.slice(0,t))))}};function t(e){let t=e;for(;t.endsWith(`/`)&&t.length>1;)t=t.slice(0,-1);return t}export{e as MemoryFileSystem};

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@gitkraken/agent-tools",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Host configuration and path helpers for AI coding agent integrations, with an in-memory filesystem for testing.",
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Axosoft, LLC dba GitKraken",
+  "engines": {
+    "node": ">= 22"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "jsonc-parser": "^3.3.1",
+    "smol-toml": "^1.9.0",
+    "@gitkraken/shared-tools": "^0.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.1"
+  },
+  "scripts": {
+    "build": "tsdown --config-loader=unrun",
+    "build:dev": "tsdown --config tsdown.dev.config.ts --config-loader=unrun",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
 }