The open-source agent harness - the runtime layer that turns an LLM into a working agent.
Support git-mounted skills end to end.
debajyoti-truefoundry032058da4cc0
diff --git a/eslint.config.mjs b/eslint.config.mjsindex ffac6dd71..9af08830c 100644--- a/eslint.config.mjs+++ b/eslint.config.mjs@@ -42,7 +42,15 @@ const browserGlobals = {export default defineConfig({- ignores: ['**/node_modules/**', '**/dist/**', '**/coverage/**', '**/.pnpm-store/**', '**/.eslintcache'],+ ignores: [+ '**/node_modules/**',+ '**/dist/**',+ '**/coverage/**',+ '**/.pnpm-store/**',+ '**/.eslintcache',+ // Excluded from package tsconfigs; run via tsx/jest, not the type-aware ESLint project.+ '**/*.test.ts',+ ],},{files: ['**/*.{js,mjs,cjs,ts}'],diff --git a/package.json b/package.jsonindex 7c86e385e..eba747906 100644--- a/package.json+++ b/package.json@@ -10,7 +10,7 @@"format": "prettier --write . --cache --config .prettierrc","format:check": "prettier --check \"**/*.{js,jsx,ts,tsx,json,md}\" --cache --error-on-unmatched-pattern --config .prettierrc","format:fix": "prettier --write \"**/*.{js,jsx,ts,tsx,json,md}\" --cache --config .prettierrc",- "test": "pnpm --filter @truefoundry/utils test",+ "test": "pnpm --filter @truefoundry/utils test && pnpm --filter @truefoundry/server test && pnpm --filter frontend test","dev:server": "pnpm --filter @truefoundry/server dev","dev:frontend": "pnpm --filter frontend dev","ui:shot": "node ui-shots/shot.mjs",diff --git a/packages/frontend/package.json b/packages/frontend/package.jsonindex a0c48499f..5fc1778ed 100644--- a/packages/frontend/package.json+++ b/packages/frontend/package.json@@ -10,7 +10,8 @@"dev": "vite","build": "tsc --noEmit && vite build","preview": "vite preview",- "typecheck": "tsc --noEmit"+ "typecheck": "tsc --noEmit",+ "test": "tsx --test src/**/*.test.ts"},"dependencies": {"@assistant-ui/core": "0.2.21",@@ -22,13 +23,14 @@"react": "^19.2.4","react-dom": "^19.2.4","tfy-web-components": "^0.0.31",- "truefoundry-gateway-sdk": "0.4.0-rc.1"+ "truefoundry-gateway-sdk": "0.4.0-rc.2"},"devDependencies": {"@types/react": "^19.2.17","@types/react-dom": "^19.2.2","@vitejs/plugin-react": "^4.7.0","playwright-core": "^1.61.1",+ "tsx": "^4.16.2","typescript": "^5.9.3","vite": "^6.3.5","vite-plugin-monaco-editor-esm": "^2.0.2"diff --git a/packages/frontend/src/App.tsx b/packages/frontend/src/App.tsxindex bb9851a12..58c4ecd35 100644--- a/packages/frontend/src/App.tsx+++ b/packages/frontend/src/App.tsx@@ -39,10 +39,10 @@ const slotOverrides = {function ThreadTitleSync() {const aui = useAui();const isRunning = useAuiState(state => state.threads.main.isRunning);- const mounted = useRef(false);+ const mountedRef = useRef(false);useEffect(() => {- if (!mounted.current) {- mounted.current = true;+ if (!mountedRef.current) {+ mountedRef.current = true;return;}void aui.threads().reload();diff --git a/packages/frontend/src/ComposerCatalogControls.tsx b/packages/frontend/src/ComposerCatalogControls.tsxindex baf4612e0..c9b303e02 100644--- a/packages/frontend/src/ComposerCatalogControls.tsx+++ b/packages/frontend/src/ComposerCatalogControls.tsx@@ -10,7 +10,7 @@ import {type SkillEntry,} from './catalog';import { ChevronDownIcon, SearchIcon, SparklesIcon } from './icons';-import { setSelectedSkillNames, useSelectedSkillNames } from './skillsSelection';+import { selectedSkillNamesFromSpec, skillMountsFromNames } from './skillMounts';export type CatalogTab = 'connectors' | 'skills' | 'attachment';@@ -36,7 +36,7 @@ function initialFor(name: string): string {/*** Composer catalog UI: model chip, skills chip, or Connectors/Skills/Attachment panel.- * Skills selection is local-only — harness rejects agent_spec.skills for now.+ * Skills are resolved from the catalog into git mounts on agent_spec.skills.*/export function ComposerCatalogControls({mode = 'panel',@@ -54,7 +54,7 @@ export function ComposerCatalogControls({const [error, setError] = useState<string | null>(null);const [query, setQuery] = useState('');const [tab, setTab] = useState<CatalogTab>(initialTab);- const selectedSkillNames = useSelectedSkillNames();+ const selectedSkillNames = useMemo(() => selectedSkillNamesFromSpec(agentSpec?.skills), [agentSpec?.skills]);const sandboxSelected = agentSpec?.config?.sandbox?.enabled === true;const sandboxAvailable = capabilities.sandbox.enabled;const skillsDisabled = disabled || !sandboxSelected;@@ -128,6 +128,12 @@ export function ComposerCatalogControls({});};+ const applySkillSelection = (nextNames: Set<string>) => {+ updateAgentSpec({+ skills: skillMountsFromNames(nextNames, skills),+ });+ };+if (mode === 'sandbox') {const unavailableReason = 'Sandbox is not configured on this server.';return (@@ -150,8 +156,8 @@ export function ComposerCatalogControls({enabled,},},+ ...(!enabled ? { skills: [] } : {}),});- if (!enabled) setSelectedSkillNames(new Set());}}><span className="sandbox-status" aria-hidden />@@ -424,7 +430,7 @@ export function ComposerCatalogControls({} else {for (const skill of filteredSkills) next.delete(skill.name);}- setSelectedSkillNames(next);+ applySkillSelection(next);}}/>Select all@@ -449,7 +455,7 @@ export function ComposerCatalogControls({const next = new Set(selectedSkillNames);if (event.target.checked) next.add(skill.name);else next.delete(skill.name);- setSelectedSkillNames(next);+ applySkillSelection(next);}}/></label>diff --git a/packages/frontend/src/catalog.ts b/packages/frontend/src/catalog.tsindex 1aa277fc6..82fa5a8c3 100644--- a/packages/frontend/src/catalog.ts+++ b/packages/frontend/src/catalog.ts@@ -15,7 +15,7 @@ export interface SkillEntry {name: string;url: string;path?: string;- reference?: string;+ ref?: string;description: string;}diff --git a/packages/frontend/src/skillMounts.test.ts b/packages/frontend/src/skillMounts.test.tsnew file mode 100644index 000000000..2d7dd0492--- /dev/null+++ b/packages/frontend/src/skillMounts.test.ts@@ -0,0 +1,56 @@+import assert from 'node:assert/strict';+import { describe, it } from 'node:test';+import type { SkillEntry } from './catalog';+import { DEFAULT_SKILL_REF, selectedSkillNamesFromSpec, skillMountsFromNames, toGitSkillMount } from './skillMounts';++const entry: SkillEntry = {+ name: 'pr-review',+ url: 'https://github.com/acme/skills',+ path: 'skills/pr-review',+ ref: 'v1.2.0',+ description: 'Reviews pull requests',+};++describe('toGitSkillMount', () => {+ it('maps catalog fields to a git mount', () => {+ assert.deepEqual(toGitSkillMount(entry), {+ type: 'git',+ url: 'https://github.com/acme/skills',+ path: 'skills/pr-review',+ name: 'pr-review',+ description: 'Reviews pull requests',+ ref: 'v1.2.0',+ });+ });++ it('defaults omitted ref to HEAD', () => {+ const mount = toGitSkillMount({+ name: 'echo',+ url: 'https://github.com/acme/skills',+ description: 'Echo',+ });+ assert.equal(mount.ref, DEFAULT_SKILL_REF);+ });+});++describe('skillMountsFromNames', () => {+ it('preserves selection order of names that exist in the catalog', () => {+ const other: SkillEntry = {+ name: 'echo',+ url: 'https://github.com/acme/skills',+ description: 'Echo',+ };+ const mounts = skillMountsFromNames(new Set(['missing', 'echo', 'pr-review']), [entry, other]);+ assert.deepEqual(+ mounts.map(m => m.name),+ ['echo', 'pr-review'],+ );+ });+});++describe('selectedSkillNamesFromSpec', () => {+ it('reads names from persisted git mounts', () => {+ const names = selectedSkillNamesFromSpec([toGitSkillMount(entry)]);+ assert.deepEqual([...names], ['pr-review']);+ });+});diff --git a/packages/frontend/src/skillMounts.ts b/packages/frontend/src/skillMounts.tsnew file mode 100644index 000000000..e1b4f8b77--- /dev/null+++ b/packages/frontend/src/skillMounts.ts@@ -0,0 +1,44 @@+/**+ * Maps skills.yaml catalog rows to git mounts persisted on agent_spec.skills.+ * Always sends `ref` (catalog `ref`, or HEAD when omitted). The sandbox+ * git_downloader resolves branch/tag refs via git ls-remote before sparse-clone.+ */+import type { AgentSpec } from '@truefoundry/assistant-ui-runtime';+import type { SkillEntry } from './catalog';++/** Default git ref when skills.yaml omits `ref` (tracks the remote default branch). */+export const DEFAULT_SKILL_REF = 'HEAD';++export type GitSkillMount = Extract<NonNullable<AgentSpec['skills']>[number], { type: 'git' }>;++function isGitSkillMount(skill: NonNullable<AgentSpec['skills']>[number]): skill is GitSkillMount {+ return skill.type === 'git';+}++export function toGitSkillMount(entry: SkillEntry): GitSkillMount {+ const mount: GitSkillMount = {+ type: 'git',+ url: entry.url,+ name: entry.name,+ description: entry.description,+ ref: entry.ref ?? DEFAULT_SKILL_REF,+ };+ if (entry.path !== undefined) {+ mount.path = entry.path;+ }+ return mount;+}++export function skillMountsFromNames(names: ReadonlySet<string>, catalog: readonly SkillEntry[]): GitSkillMount[] {+ const byName = new Map(catalog.map(entry => [entry.name, entry]));+ const mounts: GitSkillMount[] = [];+ for (const name of names) {+ const entry = byName.get(name);+ if (entry) mounts.push(toGitSkillMount(entry));+ }+ return mounts;+}++export function selectedSkillNamesFromSpec(skills: AgentSpec['skills']): ReadonlySet<string> {+ return new Set((skills ?? []).filter(isGitSkillMount).map(skill => skill.name));+}diff --git a/packages/frontend/src/skillsSelection.ts b/packages/frontend/src/skillsSelection.tsdeleted file mode 100644index 2c5b68978..000000000--- a/packages/frontend/src/skillsSelection.ts+++ /dev/null@@ -1,24 +0,0 @@-import { useSyncExternalStore } from 'react';--/**- * Selected skills, shared between the composer chip and the catalog panel- * (separate component instances). Local-only — harness rejects agent_spec.skills.- */-let selectedSkillNames: ReadonlySet<string> = new Set();-const listeners = new Set<() => void>();--function subscribe(listener: () => void): () => void {- listeners.add(listener);- return () => {- listeners.delete(listener);- };-}--export function setSelectedSkillNames(next: ReadonlySet<string>): void {- selectedSkillNames = new Set(next);- for (const listener of listeners) listener();-}--export function useSelectedSkillNames(): ReadonlySet<string> {- return useSyncExternalStore(subscribe, () => selectedSkillNames);-}diff --git a/packages/frontend/tsconfig.json b/packages/frontend/tsconfig.jsonindex 9b4050a8d..4470695e6 100644--- a/packages/frontend/tsconfig.json+++ b/packages/frontend/tsconfig.json@@ -20,5 +20,6 @@"isolatedModules": true,"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo"},- "include": ["src"]+ "include": ["src"],+ "exclude": ["src/**/*.test.ts"]}diff --git a/packages/harness/src/agent-session/index.ts b/packages/harness/src/agent-session/index.tsindex 3115ab8fc..ce0e839fe 100644--- a/packages/harness/src/agent-session/index.ts+++ b/packages/harness/src/agent-session/index.ts@@ -4,7 +4,7 @@*/export { AgentSpecSchema, DEFAULT_AGENT_CONFIG_ITERATION_LIMIT, RuntimeConfigSchema } from './schemas/agentSpec';-export type { AgentSpec } from './schemas/agentSpec';+export type { AgentSpec, SkillMount } from './schemas/agentSpec';export {CancellationReason,diff --git a/packages/harness/src/agent-session/schemas/agentSpec.ts b/packages/harness/src/agent-session/schemas/agentSpec.tsindex 7034884b4..7f140708d 100644--- a/packages/harness/src/agent-session/schemas/agentSpec.ts+++ b/packages/harness/src/agent-session/schemas/agentSpec.ts@@ -199,11 +199,55 @@ export const RuntimeConfigSchema = z.openapi('RuntimeConfig');// --- Skills ---+// Git mounts mirror the gateway SkillMountGitSchema. The sandbox git_downloader+// resolves `ref` (branch/tag/SHA) to an object id before sparse-cloning.++// GitHub is exactly owner/repo; GitLab allows subgroups (group[/subgroup...]/project, ≥2 segments).+const GIT_URL_REGEX =+ /^https:\/\/(github\.com\/[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+|gitlab\.com\/[A-Za-z0-9._-]+(?:\/[A-Za-z0-9._-]+)+)(\/|\.git)?$/;+const GIT_REF_REGEX = /^[A-Za-z0-9._\-/]+$/;+const SKILL_NAME_REGEX = /^[A-Za-z0-9._-]+$/;+const SKILL_PATH_REGEX = /^[A-Za-z0-9._\-/]+$/;+const hasParentTraversal = (value: string): boolean => value.split('/').includes('..');const SkillMountSchema = z.object({- name: z.string().trim().min(1).describe('Name of a skill declared in skills.yaml.'),- preload: z.boolean().default(false).describe('If true, the SKILL.md content is injected into the agent context.'),+ type: z.literal('git'),+ url: z+ .string()+ .trim()+ .min(1)+ .regex(GIT_URL_REGEX, 'Must be a GitHub or GitLab HTTPS URL')+ .refine(v => !hasParentTraversal(v), 'URL must not contain ".." segments')+ .describe('Full HTTPS URL of a GitHub or GitLab repository.'),+ path: z+ .string()+ .trim()+ .min(1)+ .regex(SKILL_PATH_REGEX, 'Path may only contain letters, numbers, ".", "_", "-", and "/"')+ .refine(v => !hasParentTraversal(v), 'Path must not contain ".." segments')+ .refine(v => !v.split('/').includes('.'), 'Path must not contain "." segments')+ .refine(v => v.replace(/^\/+|\/+$/g, '').length > 0, 'Path must reference a subdirectory, not only slashes')+ .optional()+ .describe('Path to the skill directory within the repository. Omit to use the repository root.'),+ name: z+ .string()+ .trim()+ .min(1)+ .max(64)+ .regex(SKILL_NAME_REGEX, 'Name may only contain letters, numbers, ".", "_", and "-"')+ .refine(v => v !== '.' && v !== '..', 'Name must not be "." or ".."')+ .refine(v => !v.startsWith('.tfy-'), 'Name must not use the reserved ".tfy-" prefix')+ .describe('Name for the skill, used as directory name in sandbox.'),+ description: z.string().trim().min(1).describe('Concise guidance for when the agent should use the skill.'),+ ref: z+ .string()+ .trim()+ .min(1)+ .regex(GIT_REF_REGEX, 'Ref may only contain letters, numbers, ".", "_", "-", and "/"')+ .refine(v => !hasParentTraversal(v), 'Ref must not contain ".." segments')+ .refine(v => v.replace(/^\/+|\/+$/g, '').length > 0, 'Ref must not consist only of slashes')+ .describe('Git ref — branch name, tag, or commit SHA.'),}).openapi('SkillMount');@@ -236,3 +280,4 @@ export const AgentSpecSchema = z.openapi('AgentSpec');export type AgentSpec = z.infer<typeof AgentSpecSchema>;+export type SkillMount = z.infer<typeof SkillMountSchema>;diff --git a/packages/harness/src/core/sandbox/scripts/git_downloader.py b/packages/harness/src/core/sandbox/scripts/git_downloader.pyindex 259f1719b..516c5d1ed 100644--- a/packages/harness/src/core/sandbox/scripts/git_downloader.py+++ b/packages/harness/src/core/sandbox/scripts/git_downloader.py@@ -6,17 +6,18 @@"""Materialize git skill directories into TFY_SKILLS_DIR (default /opt/tfy/skills). Requires `git`.-Each git skill (AGENT_GIT_SKILLS) is materialized with a SHA-pinned, blob-filtered sparse `git`-clone that fetches only the requested subdir at the requested commit, keyed by name. A single on-disk-state file records the installed commit + subdir per name so a skill whose ref hasn't moved (same-commit and subdir) is skipped instead of re-cloning every run, and skills no longer desired are-pruned from disk. A sparse clone is used instead of a full repo tarball because its cost is+Each git skill (AGENT_GIT_SKILLS) is materialized with a blob-filtered sparse `git` clone that+fetches only the requested subdir at a resolved object id, keyed by name. Mount `ref` values+(branch, tag, or full object id) are resolved here via `git ls-remote` — the host never spawns+git. A single on-disk state file records the installed object id + subdir per name so a skill+whose tip hasn't moved is skipped instead of re-cloning every run, and skills no longer desired+are pruned from disk. A sparse clone is used instead of a full repo tarball because its cost is~constant in the subdir size rather than the whole-repo size, which is dramatically faster for asmall skill living in a large monorepo.Optional env:- - AGENT_GIT_SKILLS (base64-encoded JSON list of {name, clone_url, subdir, commit_sha}; empty- clears git downloads)+ - AGENT_GIT_SKILLS (base64-encoded JSON list of {name, url, path, ref}; empty+ clears git downloads). `ref` is a branch, tag, or full object id.- TFY_SKILLS_DIR: override the skills directory (default /opt/tfy/skills)."""@@ -42,9 +43,11 @@ GIT_CLONE_TIMEOUT_SECONDS = 120# sparse clone already bounds a subdir skill to its subdir; this also guards the whole-repo (root# subdir) case where checkout hydrates every file.GIT_SKILL_MAX_BYTES = 200 * 1024 * 1024 # 200MB installed-# A resolved git object id: sha1 (40 hex) or sha256 (64 hex). Validated here because commit_sha is-# passed as a `git fetch` argument, so it must never be interpretable as an option or injected arg.-COMMIT_SHA_RE = re.compile(r"^(?:[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$")+# Resolved object id used for fetch + skip state (sha1 / sha256).+OBJECT_ID_RE = re.compile(r"^(?:[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$")+# Mount ref (branch/tag/SHA) charset — must match host AgentSpec SkillMount.ref validation.+# Validated before the value is passed to `git ls-remote` / used as a fetch arg fallback.+GIT_REF_RE = re.compile(r"^[A-Za-z0-9._\-/]+$")SKILLS_ROOT = Path(os.environ.get("TFY_SKILLS_DIR", DEFAULT_SKILLS_DIR))STATE_PATH = SKILLS_ROOT / STATE_FILE_NAME@@ -70,64 +73,67 @@ def skill_dir(name: str) -> Path | None:class GitSkill(BaseModel):- """A git skill to materialize: its sandbox dir name, the repo clone URL, the subdir within the- repo, and the resolved commit SHA. The clone URL and SHA are passed to `git`, so both are format-- validated here (defense in depth — the gateway already validates and builds them) to keep an- unexpected value from being interpreted as a git option or reaching a non-public host."""+ """A git skill to materialize: `name`, `url`, `path`, and mount `ref` (branch, tag, or object id).+ This script resolves `ref` via `git ls-remote` in the sandbox, then sparse-fetches the resolved+ object id. The url and ref are format-validated here (defense in depth) so an unexpected value+ can't be interpreted as a git option or reach a non-public host."""model_config = ConfigDict(extra="ignore")name: str- clone_url: str- subdir: str = ""- commit_sha: str+ url: str+ path: str = ""+ # Branch, tag, or full object id from the agent_spec mount (resolved in-sandbox before fetch).+ ref: str- @field_validator("clone_url")+ @field_validator("url")@classmethod- def _validate_clone_url(cls, v: str) -> str:+ def _validate_url(cls, v: str) -> str:# Only the two public hosts the gateway supports. Anchoring on the "https://<host>/" prefix# blocks non-https schemes (file://, ext::, ssh) and any other host, so this URL can't be# turned into an SSRF/local-file/command vector once it reaches `git`.if not (v.startswith("https://github.com/") or v.startswith("https://gitlab.com/")):- raise ValueError(f"git skill clone_url must be a github.com/gitlab.com https URL: {v!r}")+ raise ValueError(f"git skill url must be a github.com/gitlab.com https URL: {v!r}")return v- @field_validator("commit_sha")+ @field_validator("ref")@classmethod- def _validate_commit_sha(cls, v: str) -> str:- if not COMMIT_SHA_RE.match(v):- raise ValueError(f"git skill commit_sha must be a 40- or 64-char hex object id: {v!r}")+ def _validate_ref(cls, v: str) -> str:+ if not v or ".." in v.split("/") or not GIT_REF_RE.match(v):+ raise ValueError(f"git skill ref is invalid: {v!r}")+ if v.replace("/", "") == "":+ raise ValueError(f"git skill ref must not consist only of slashes: {v!r}")return v- @field_validator("subdir")+ @field_validator("path")@classmethod- def _validate_subdir(cls, v: str) -> str:+ def _validate_path(cls, v: str) -> str:# Relative subpath within the repo. Reject absolute paths and ".." segments so it can't# escape the repo root. Leading/trailing slashes are stripped (repo root == ""). A leading# "-" is safe because subdirs are fed to `git sparse-checkout set` via stdin, never as args.if v.startswith("/"):- raise ValueError(f"git skill subdir must be relative: {v!r}")+ raise ValueError(f"git skill path must be relative: {v!r}")stripped = v.strip("/")if stripped and ".." in stripped.split("/"):- raise ValueError(f"git skill subdir must not contain '..': {v!r}")+ raise ValueError(f"git skill path must not contain '..': {v!r}")return strippedclass DownloadedGitSkill(BaseModel):- """A git skill recorded on disk: its dir name, the commit it was installed at, and the repo- subdir it was installed from. The commit lets a later run skip re-downloading when the requested- commit is unchanged; the subdir is part of the identity so that changing the subdir at the same- commit still triggers a re-download instead of serving the previously-installed layout."""+ """A git skill recorded on disk: its dir name, the object id it was installed at, and the repo+ path it was installed from. The ref lets a later run skip re-downloading when the requested+ pin is unchanged; the path is part of the identity so that changing the path at the same+ pin still triggers a re-download instead of serving the previously-installed layout."""model_config = ConfigDict(extra="ignore")name: str- # Empty when migrated from a pre-commit-tracking state file — treated as "unknown", forcing a+ # Empty when migrated from a pre-pin-tracking state file — treated as "unknown", forcing a# one-time re-download while still keeping the name tracked for pruning.- commit_sha: str = ""- # Repo subdir the skill was installed from (repo root == ""). Empty on entries written before- # subdir tracking; a mismatch against the requested subdir forces a one-time re-download.- subdir: str = ""+ ref: str = ""+ # Repo path the skill was installed from (repo root == ""). Empty on entries written before+ # path tracking; a mismatch against the requested path forces a one-time re-download.+ path: str = ""class SkillDownloaderState(BaseModel):@@ -137,10 +143,27 @@ class SkillDownloaderState(BaseModel):downloaded_git_skills: list[DownloadedGitSkill] = Field(default_factory=list,- description="Git skills successfully downloaded (name + installed commit SHA).",+ description="Git skills successfully downloaded (name + installed object id).",)+def _migrate_downloaded_git_skills(entries: list[object]) -> list[dict[str, object]]:+ """Normalize state entries: rename legacy `commit_sha` → `ref` and `subdir` → `path`."""+ migrated: list[dict[str, object]] = []+ for item in entries:+ if not isinstance(item, dict):+ continue+ entry = dict(item)+ if "ref" not in entry and isinstance(entry.get("commit_sha"), str):+ entry["ref"] = entry["commit_sha"]+ entry.pop("commit_sha", None)+ if "path" not in entry and isinstance(entry.get("subdir"), str):+ entry["path"] = entry["subdir"]+ entry.pop("subdir", None)+ migrated.append(entry)+ return migrated++def load_state() -> SkillDownloaderState:if not STATE_PATH.is_file():return SkillDownloaderState()@@ -150,14 +173,16 @@ def load_state() -> SkillDownloaderState:return SkillDownloaderState()if not isinstance(raw, dict):return SkillDownloaderState()- # Migrate a pre-commit-tracking state file: its `downloaded_git_names` (list of names, no commit)- # becomes entries with an empty commit_sha. That keeps the names tracked so undesired skills are- # still pruned, and forces a one-time re-download (empty != any requested commit). Skipped when- # the new field is already present so we never clobber real commits.+ # Migrate a pre-pin-tracking state file: its `downloaded_git_names` (list of names, no pin)+ # becomes entries with an empty ref. That keeps the names tracked so undesired skills are+ # still pruned, and forces a one-time re-download (empty != any requested pin). Skipped when+ # the new field is already present so we never clobber real pins.if "downloaded_git_skills" not in raw and isinstance(raw.get("downloaded_git_names"), list):raw["downloaded_git_skills"] = [- {"name": n, "commit_sha": ""} for n in raw["downloaded_git_names"] if isinstance(n, str)+ {"name": n, "ref": ""} for n in raw["downloaded_git_names"] if isinstance(n, str)]+ if isinstance(raw.get("downloaded_git_skills"), list):+ raw["downloaded_git_skills"] = _migrate_downloaded_git_skills(raw["downloaded_git_skills"])try:return SkillDownloaderState.model_validate(raw)except ValidationError:@@ -260,24 +285,57 @@ def _run_git(return proc+def _parse_ls_remote_object_id(stdout: str) -> str | None:+ """Prefer a peeled `ref^{}` line (annotated tags), else the first object id."""+ first: str | None = None+ for line in stdout.splitlines():+ trimmed = line.strip()+ if not trimmed:+ continue+ parts = trimmed.split(None, 1)+ sha = parts[0]+ name = parts[1] if len(parts) > 1 else ""+ if name.endswith("^{}"):+ return sha+ if first is None:+ first = sha+ return first+++def _resolve_object_id(url: str, ref: str, cwd: Path) -> str:+ """Resolve a mount ref (branch/tag/SHA) to an object id inside the sandbox.++ Full object ids are used as-is (`git ls-remote` does not advertise bare SHAs on+ GitHub/GitLab). Branches and tags are resolved via `git ls-remote` so a branch tip+ advances on later sandbox inits.+ """+ if OBJECT_ID_RE.match(ref):+ return ref+ proc = _run_git(["ls-remote", url, ref], cwd=cwd)+ oid = _parse_ls_remote_object_id(proc.stdout or "")+ if oid is None:+ raise GitSkillError(f"git ls-remote returned no commit for {url} ref {ref}")+ return oid++def _git_fetch_repo(- clone_url: str, commit_sha: str, subdirs: list[str], parent_dir: Path+ url: str, object_id: str, paths: list[str], parent_dir: Path) -> Path:- """SHA-pinned, shallow, blob-filtered sparse checkout of `subdirs` into a fresh repo under+ """Object-id-pinned, shallow, blob-filtered sparse checkout of `paths` into a fresh repo under`parent_dir`, returning the repo working directory.- When every requested subdir is the repo root ("") we can't sparse-restrict, so we do a full- shallow checkout (all blobs). Otherwise we cone-sparse to just the requested subdirs and use- --filter=blob:none so only those subdirs' blobs are fetched — the whole point of the approach.- Subdirs are fed to `git sparse-checkout set` via stdin so a subdir value can never be read as an+ When every requested path is the repo root ("") we can't sparse-restrict, so we do a full+ shallow checkout (all blobs). Otherwise we cone-sparse to just the requested paths and use+ --filter=blob:none so only those paths' blobs are fetched — the whole point of the approach.+ Paths are fed to `git sparse-checkout set` via stdin so a path value can never be read as anoption/argument. Fetching by object id relies on the server allowing it, which github.com andgitlab.com both do."""repo = parent_dir / "repo"_run_git(["init", "-q", os.fspath(repo)], cwd=parent_dir)- _run_git(["remote", "add", "origin", clone_url], cwd=repo)+ _run_git(["remote", "add", "origin", url], cwd=repo)- cone_dirs = [s for s in dict.fromkeys(subdirs) if s] # de-duped, root ("") dropped- want_full_tree = any(s == "" for s in subdirs)+ cone_dirs = [s for s in dict.fromkeys(paths) if s] # de-duped, root ("") dropped+ want_full_tree = any(s == "" for s in paths)if not want_full_tree and cone_dirs:_run_git(["sparse-checkout", "init", "--cone"], cwd=repo)_run_git(@@ -289,7 +347,7 @@ def _git_fetch_repo(fetch_args = ["-c", "protocol.file.allow=never", "fetch", "-q", "--depth", "1"]if not want_full_tree:fetch_args.append("--filter=blob:none")- fetch_args += ["origin", commit_sha]+ fetch_args += ["origin", object_id]_run_git(fetch_args, cwd=repo)_run_git(@@ -318,16 +376,16 @@ def _install_git_skill(repo_root: Path, skill: GitSkill) -> None:if dest is None:raise GitSkillError(f"Git skill: unsafe directory name {skill.name!r}")repo_root_resolved = repo_root.resolve()- src = (repo_root / skill.subdir).resolve() if skill.subdir else repo_root_resolved- # Defense in depth: even though subdir is validated, ensure the resolved source stays within the+ src = (repo_root / skill.path).resolve() if skill.path else repo_root_resolved+ # Defense in depth: even though path is validated, ensure the resolved source stays within the# cloned repo (guards against a symlinked directory component pointing outside the checkout).if src != repo_root_resolved and not src.is_relative_to(repo_root_resolved):raise GitSkillError(- f"Git skill {skill.name}: subdirectory '{skill.subdir}' escapes the repository"+ f"Git skill {skill.name}: path '{skill.path}' escapes the repository")if not src.is_dir():raise GitSkillError(- f"Git skill {skill.name}: subdirectory '{skill.subdir}' not found in repository"+ f"Git skill {skill.name}: path '{skill.path}' not found in repository")if _installed_size_bytes(src) > GIT_SKILL_MAX_BYTES:raise GitSkillError(@@ -360,27 +418,31 @@ def _install_git_skill(repo_root: Path, skill: GitSkill) -> None:raise GitSkillError(f"Failed to install git skill {skill.name}: {e}")-def _mark_git_downloaded(state: SkillDownloaderState, skill: GitSkill) -> None:- """Upsert a git skill's installed commit + subdir so the next run can skip it when both are unchanged."""+def _mark_git_downloaded(+ state: SkillDownloaderState, skill: GitSkill, object_id: str+) -> None:+ """Upsert a git skill's installed object id + path so the next run can skip when both match."""for entry in state.downloaded_git_skills:if entry.name == skill.name:- entry.commit_sha = skill.commit_sha- entry.subdir = skill.subdir+ entry.ref = object_id+ entry.path = skill.pathreturnstate.downloaded_git_skills.append(- DownloadedGitSkill(name=skill.name, commit_sha=skill.commit_sha, subdir=skill.subdir)+ DownloadedGitSkill(name=skill.name, ref=object_id, path=skill.path))-def _git_skill_already_installed(state: SkillDownloaderState, skill: GitSkill) -> bool:- """True only when the skill is recorded at the requested commit AND subdir AND its directory is- still present. Re-download otherwise (commit moved, subdir changed, first install, or the dir was- removed out-of-band) so the prompt never points at a missing/stale skill dir."""+def _git_skill_already_installed(+ state: SkillDownloaderState, skill: GitSkill, object_id: str+) -> bool:+ """True only when the skill is recorded at the resolved object id AND path AND its directory is+ still present. Re-download otherwise (branch tip moved, path changed, first install, or the+ dir was removed out-of-band) so the prompt never points at a missing/stale skill dir."""dir_ = skill_dir(skill.name)if dir_ is None or not dir_.is_dir():return Falsereturn any(- e.name == skill.name and e.commit_sha == skill.commit_sha and e.subdir == skill.subdir+ e.name == skill.name and e.ref == object_id and e.path == skill.pathfor e in state.downloaded_git_skills)@@ -388,32 +450,38 @@ def _git_skill_already_installed(state: SkillDownloaderState, skill: GitSkill) -def download_git_skills(git_skills: list[GitSkill], state: SkillDownloaderState) -> int:- """Ensure desired git skills are installed at their requested commit, skipping any already present- at that commit so an unchanged ref no longer re-clones every run.+ """Ensure desired git skills are installed at their resolved object id, skipping any already+ present at that pin so an unchanged tip no longer re-clones every run.+ Ref resolution (`git ls-remote`) runs here in the sandbox — the host never spawns git.Failures are isolated per repo group and per skill so one bad repo/subdir doesn't prevent therest from being attempted; each failure is logged to stderr. Returns the number of skills that are- satisfied this run — freshly installed OR already present at the requested commit (never raises).+ satisfied this run — freshly installed OR already present at the resolved pin (never raises).The caller (run_git_download) compares this to the number requested and exits non-zero if any aremissing, so the overall behaviour is fail-closed."""SKILLS_ROOT.mkdir(parents=True, exist_ok=True)- # Skip skills already installed at the requested commit; only the rest need a clone.- pending: list[GitSkill] = []+ # Resolve mount refs → object ids, then skip skills already installed at that pin.+ pending: list[tuple[GitSkill, str]] = []satisfied = 0for skill in git_skills:- if _git_skill_already_installed(state, skill):+ try:+ object_id = _resolve_object_id(skill.url, skill.ref, SKILLS_ROOT)+ except GitSkillError as e:+ print(f"WARNING: {e} (skill: {skill.name})", file=sys.stderr)+ continue+ if _git_skill_already_installed(state, skill, object_id):satisfied += 1else:- pending.append(skill)+ pending.append((skill, object_id))- # Group pending by (repo, commit) so a repo shared by several skills is cloned once and its- # needed subdirs fetched together in a single sparse checkout.- skills_by_repo: dict[tuple[str, str], list[GitSkill]] = {}- for skill in pending:- skills_by_repo.setdefault((skill.clone_url, skill.commit_sha), []).append(skill)+ # Group pending by (repo, object id) so a repo shared by several skills is cloned once and its+ # needed paths fetched together in a single sparse checkout.+ skills_by_repo: dict[tuple[str, str], list[tuple[GitSkill, str]]] = {}+ for skill, object_id in pending:+ skills_by_repo.setdefault((skill.url, object_id), []).append((skill, object_id))- for (clone_url, commit_sha), skills in skills_by_repo.items():+ for (url, object_id), group in skills_by_repo.items():try:with tempfile.TemporaryDirectory(prefix=".git-skill-dl-",@@ -421,13 +489,16 @@ def download_git_skills(ignore_cleanup_errors=True,) as tmp_str:repo_root = _git_fetch_repo(- clone_url, commit_sha, [s.subdir for s in skills], Path(tmp_str)+ url,+ object_id,+ [s.path for s, _ in group],+ Path(tmp_str),)- # Install each skill independently so a bad subdir only skips that one skill.- for skill in skills:+ # Install each skill independently so a bad path only skips that one skill.+ for skill, oid in group:try:_install_git_skill(repo_root, skill)- _mark_git_downloaded(state, skill)+ _mark_git_downloaded(state, skill, oid)satisfied += 1except GitSkillError as e:print(f"WARNING: {e}", file=sys.stderr)@@ -436,7 +507,7 @@ def download_git_skills(# run_git_download turns a non-zero failed count into a non-zero exit (fail-closed), which# fails the whole agent request. We still don't purge a previously installed copy here, so# a reused sandbox keeps the old files on disk even though this run is about to fail.- names = ", ".join(s.name for s in skills)+ names = ", ".join(s.name for s, _ in group)print(f"WARNING: {e} (skills: {names})", file=sys.stderr)save_state(state)return satisfieddiff --git a/packages/harness/src/core/sandbox/skills/SkillMounter.ts b/packages/harness/src/core/sandbox/skills/SkillMounter.tsindex b45f022bb..e044f31b8 100644--- a/packages/harness/src/core/sandbox/skills/SkillMounter.ts+++ b/packages/harness/src/core/sandbox/skills/SkillMounter.ts@@ -8,25 +8,27 @@ import type { ISkillMounter } from './ISkillMounter';// Absolute path the git skill downloader script is uploaded to before it is run.const GIT_DOWNLOADER_PATH = '/opt/tfy/git_downloader.py';-// A git-sourced skill materialized by a SHA-pinned sparse clone. Git skills never preload — their-// SKILL.md is read from disk at runtime (only name/description/path are advertised in the prompt).+// A git-sourced skill materialized by a sparse clone in the sandbox (git_downloader.py). Git skills+// never preload — their SKILL.md is read from disk at runtime (only name/description/path are+// advertised in the prompt). Wire fields match the agent_spec git mount (`url`/`path`/`name`/`ref`);+// the downloader resolves `ref` inside the sandbox before fetching.export interface GitSkill {readonly name: string;readonly description: string;// Canonical https clone URL of the github.com/gitlab.com repo (host-validated by the caller).- readonly cloneUrl: string;+ readonly url: string;// Subdirectory within the repo that holds the skill (empty = repo root).- readonly subdir: string;- // Immutable commit the sparse clone is pinned to; an unchanged commit is skipped on later runs.- readonly commitSha: string;+ readonly path: string;+ // Branch, tag, or full object id — resolved and fetched by git_downloader.py in the sandbox.+ readonly ref: string;}// Serializable descriptor handed to git_downloader.py (base64 JSON); keys match its GitSkill model.interface GitSkillSpec {name: string;- clone_url: string;- subdir: string;- commit_sha: string;+ url: string;+ path: string;+ ref: string;}export class SkillMounter implements ISkillMounter {@@ -56,9 +58,9 @@ export class SkillMounter implements ISkillMounter {// An empty desired set is also the source-neutral cleanup path for a reused sandbox.const specs: GitSkillSpec[] = this.skills.map(skill => ({name: skill.name,- clone_url: skill.cloneUrl,- subdir: skill.subdir,- commit_sha: skill.commitSha,+ url: skill.url,+ path: skill.path,+ ref: skill.ref,}));const gitSkillsB64 = Buffer.from(JSON.stringify(specs)).toString('base64');return {diff --git a/packages/harness/tests/agent-session/agentSpecSkills.test.ts b/packages/harness/tests/agent-session/agentSpecSkills.test.tsnew file mode 100644index 000000000..f81fb5f0c--- /dev/null+++ b/packages/harness/tests/agent-session/agentSpecSkills.test.ts@@ -0,0 +1,99 @@+import { AgentSpecSchema } from '../../src/agent-session/schemas/agentSpec';++const base = {+ model: { name: 'test-model' },+};++describe('AgentSpecSchema skills (git mounts)', () => {+ it('accepts a git skill mount', () => {+ const spec = AgentSpecSchema.parse({+ ...base,+ skills: [+ {+ type: 'git',+ url: 'https://github.com/acme/skills',+ path: 'skills/pr-review',+ name: 'pr-review',+ description: 'Reviews pull requests',+ ref: 'main',+ },+ ],+ });+ expect(spec.skills).toEqual([+ {+ type: 'git',+ url: 'https://github.com/acme/skills',+ path: 'skills/pr-review',+ name: 'pr-review',+ description: 'Reviews pull requests',+ ref: 'main',+ },+ ]);+ });++ it('accepts a full commit SHA as ref', () => {+ const sha = 'a'.repeat(40);+ const spec = AgentSpecSchema.parse({+ ...base,+ skills: [+ {+ type: 'git',+ url: 'https://github.com/acme/skills',+ name: 'pr-review',+ description: 'Reviews pull requests',+ ref: sha,+ },+ ],+ });+ expect(spec.skills?.[0]?.ref).toBe(sha);+ });++ it('rejects the legacy name/preload skill shape', () => {+ const result = AgentSpecSchema.safeParse({+ ...base,+ skills: [{ name: 'pr-review', preload: false }],+ });+ expect(result.success).toBe(false);+ });++ it('rejects a git skill mount without a description', () => {+ const result = AgentSpecSchema.safeParse({+ ...base,+ skills: [+ {+ type: 'git',+ url: 'https://github.com/acme/skills',+ name: 'pr-review',+ ref: 'main',+ },+ ],+ });+ expect(result.success).toBe(false);+ });++ it('strips unknown commit_sha from a git skill mount', () => {+ const result = AgentSpecSchema.safeParse({+ ...base,+ skills: [+ {+ type: 'git',+ url: 'https://github.com/acme/skills',+ name: 'pr-review',+ description: 'Reviews pull requests',+ ref: 'main',+ commit_sha: 'a'.repeat(40),+ },+ ],+ });+ expect(result.success).toBe(true);+ if (result.success) {+ expect(result.data.skills?.[0]).toEqual({+ type: 'git',+ url: 'https://github.com/acme/skills',+ name: 'pr-review',+ description: 'Reviews pull requests',+ ref: 'main',+ });+ }+ });+});diff --git a/packages/harness/tests/core/skillMounter.test.ts b/packages/harness/tests/core/skillMounter.test.tsindex 547883031..5fd8609e1 100644--- a/packages/harness/tests/core/skillMounter.test.ts+++ b/packages/harness/tests/core/skillMounter.test.ts@@ -10,9 +10,9 @@ import { SkillMounter } from '../../src/core/sandbox/skills/SkillMounter';const GIT_SKILL = {name: 'git-skill',description: 'From git',- cloneUrl: 'https://github.com/acme/skills.git',- subdir: '',- commitSha: 'a'.repeat(40),+ url: 'https://github.com/acme/skills.git',+ path: '',+ ref: 'a'.repeat(40),};// Renders a mounter's <skills> section the same way Sandbox does (empty section => '').diff --git a/packages/server/package.json b/packages/server/package.jsonindex e093069d7..51e102c77 100644--- a/packages/server/package.json+++ b/packages/server/package.json@@ -10,6 +10,7 @@"build": "tsup","dev": "tsx --env-file=.env src/main.ts","typecheck": "tsc --noEmit",+ "test": "tsx --test src/**/*.test.ts","start": "node dist/main.js"},"dependencies": {diff --git a/packages/server/registry-example/skills.yaml b/packages/server/registry-example/skills.yamlindex e67bbd546..b034051ff 100644--- a/packages/server/registry-example/skills.yaml+++ b/packages/server/registry-example/skills.yaml@@ -1,10 +1,11 @@# Agent skills, each a directory with a SKILL.md in a public git repository.-# url - public git repository-# path - directory containing SKILL.md (optional, repo root if omitted)-# reference - commit SHA, tag or branch to pin (optional, default branch if omitted)+# url - public git repository+# path - directory containing SKILL.md (optional, repo root if omitted)+# ref - branch, tag, or commit SHA to pin (optional, default branch if omitted)+# description - concise guidance for when to use the skillskills:- - name: pr-review- url: https://github.com/acme/agent-skills- path: skills/pr-review- reference: v1.2.0- description: Reviews pull requests for style and correctness.+ - name: algorithmic-art+ url: https://github.com/anthropics/skills+ path: skills/algorithmic-art+ ref: main+ description: Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration.diff --git a/packages/server/src/apis/sessions.ts b/packages/server/src/apis/sessions.tsindex a8151a190..bbc4eed14 100644--- a/packages/server/src/apis/sessions.ts+++ b/packages/server/src/apis/sessions.ts@@ -39,7 +39,7 @@ export function toWireSession(record: SessionRecord): Session {* is usable; otherwise an error with the status to respond with: 400 when the* spec references unknown catalog entries (a client-side spec problem), 422* when the spec is valid but this deployment cannot satisfy it (missing- * sandbox provider, unsupported skills).+ * sandbox provider).*/function validateAgentSpec(spec: AgentSpec,@@ -63,16 +63,16 @@ function validateAgentSpec(return { status: 400, message: `Unknown MCP server "${server.name}" — not declared in mcp.yaml` };}}- if (spec.config?.sandbox?.enabled && !deps.sandboxSupported) {+ const wantsSandbox = spec.config?.sandbox?.enabled === true;+ const hasSkills = (spec.skills?.length ?? 0) > 0;+ if ((wantsSandbox || hasSkills) && !deps.sandboxSupported) {return {status: 422,- message:- 'sandbox is enabled in the agent spec but this server has no sandbox provider configured — set SANDBOX_SETTINGS (and SANDBOX_API_KEY)',+ message: hasSkills+ ? 'skills require a sandbox provider — set SANDBOX_SETTINGS (and SANDBOX_API_KEY)'+ : 'sandbox is enabled in the agent spec but this server has no sandbox provider configured — set SANDBOX_SETTINGS (and SANDBOX_API_KEY)',};}- if (spec.skills?.length) {- return { status: 422, message: 'skills are not supported by this server yet' };- }return undefined;}diff --git a/packages/server/src/main.ts b/packages/server/src/main.tsindex b17d96f4f..2aefc51b9 100644--- a/packages/server/src/main.ts+++ b/packages/server/src/main.ts@@ -36,11 +36,12 @@ try {const sessionStore = new InMemorySessionStore();// Throws on malformed SANDBOX_SETTINGS; undefined when sandbox is not configured.+ const skillStore = SkillStore.load();const sandboxFactory = createServerSandboxFactory({ logger });const app = createServerApp({modelStore: ModelStore.load(),mcpStore: McpStore.load(),- skillStore: SkillStore.load(),+ skillStore,sessionStore,sessions: new Sessions({ sessionStore }),activeTurns: new ActiveTurnRegistry(),@@ -52,7 +53,7 @@ try {console.log(`Agent server listening on http://localhost:${String(info.port)} (docs at /docs)`);});- server.on('error', error => {+ server.on('error', (error: unknown) => {console.error('Failed to start server:', error instanceof Error ? error.message : error);process.exit(1);});diff --git a/packages/server/src/runtime/sandboxFactory.ts b/packages/server/src/runtime/sandboxFactory.tsindex 0a1e11f59..e6a891250 100644--- a/packages/server/src/runtime/sandboxFactory.ts+++ b/packages/server/src/runtime/sandboxFactory.ts@@ -9,7 +9,7 @@* of failing mid-turn.*/import type { TurnSandboxFactory } from '@truefoundry/utils/agent-session';-import { createSandboxProvider, Sandbox, SandboxProviderSettingsSchema } from '@truefoundry/utils/core';+import { createSandboxProvider, Sandbox, SandboxProviderSettingsSchema, SkillMounter } from '@truefoundry/utils/core';import type { Logger } from 'winston';import { ZodError } from 'zod';import { TENANT_NAME } from '../apis/sessions';@@ -66,10 +66,21 @@ export function createServerSandboxFactory(deps: { logger: Logger }): TurnSandbologger,});- // TODO(skills): wire public-server skill specs to an ISkillMounter (e.g. the git-based- // SkillMounter). Until then, public-server sandbox sessions run without skills.- return ({ spec, existingSandboxId, tracing }) =>- Promise.resolve(+ return ({ spec, existingSandboxId, tracing }) => {+ const skills = spec.skills ?? [];+ const skillMounter =+ skills.length > 0+ ? new SkillMounter(+ skills.map(skill => ({+ name: skill.name,+ description: skill.description,+ url: skill.url,+ path: skill.path ?? '',+ ref: skill.ref,+ })),+ )+ : undefined;+ return Promise.resolve(new Sandbox({provider,existingSandboxId,@@ -79,8 +90,10 @@ export function createServerSandboxFactory(deps: { logger: Logger }): TurnSandbo// for the ownership check against provider-created sandbox ids// (`<tenant>.<uuid>`). Must match the tenantName given to the provider.execExtraEnv: { TFY_TENANT_NAME: TENANT_NAME },+ ...(skillMounter ? { skillMounter } : {}),tracing,logger,}),);+ };}diff --git a/packages/server/src/store/schemas.ts b/packages/server/src/store/schemas.tsindex a1bf5cd32..2aebfa804 100644--- a/packages/server/src/store/schemas.ts+++ b/packages/server/src/store/schemas.ts@@ -88,9 +88,9 @@ export const SkillEntrySchema = zurl: z.string().url(),// Directory inside the repository containing SKILL.md. Repo root if omitted.path: z.string().min(1).optional(),- // Commit SHA, tag or branch to pin. Default branch if omitted.- reference: z.string().min(1).optional(),- // Injected into the agent context so it can judge when to use the skill.+ // Branch, tag, or commit SHA to pin. Default branch if omitted.+ ref: z.string().min(1).optional(),+ // Shown to users and persisted in the selected skill mount for runtime prompting.description: z.string().min(1),}).strict();diff --git a/packages/server/tsconfig.json b/packages/server/tsconfig.jsonindex 95656cdcf..b9dc773ea 100644--- a/packages/server/tsconfig.json+++ b/packages/server/tsconfig.json@@ -5,5 +5,5 @@"noEmit": true},"include": ["src/**/*", "tsup.config.ts"],- "exclude": ["node_modules", "dist"]+ "exclude": ["node_modules", "dist", "src/**/*.test.ts"]}diff --git a/patches/[email protected] b/patches/[email protected]deleted file mode 100644index ff7e0c7cf..000000000--- a/patches/[email protected]+++ /dev/null@@ -1,78 +0,0 @@-diff --git a/dist/cjs/api/types/TurnCreatedEvent.d.ts b/dist/cjs/api/types/TurnCreatedEvent.d.ts-index 3bae403c35a608f510f6693ba13f4947c9470b27..3ef48c579e8c962fa09f83d008ce798167d898a4 100644---- a/dist/cjs/api/types/TurnCreatedEvent.d.ts-+++ b/dist/cjs/api/types/TurnCreatedEvent.d.ts-@@ -7,7 +7,7 @@ export interface TurnCreatedEvent {- previousTurnId?: string;- input?: TrueFoundryGateway.TurnInputItem[];- state: TrueFoundryGateway.TurnStateRunning;-- createdBy: TrueFoundryGateway.Subject;-+ createdBy?: TrueFoundryGateway.Subject;- createdAt: string;- threadId?: string;- }-diff --git a/dist/cjs/serialization/types/TurnCreatedEvent.d.ts b/dist/cjs/serialization/types/TurnCreatedEvent.d.ts-index 9f4867135c22f3ee9b7851a4ec1ef766fb7bc301..5ee91460dfeb8385fe485019554f5f13f2f859fd 100644---- a/dist/cjs/serialization/types/TurnCreatedEvent.d.ts-+++ b/dist/cjs/serialization/types/TurnCreatedEvent.d.ts-@@ -13,7 +13,7 @@ export declare namespace TurnCreatedEvent {- previous_turn_id?: string | null;- input?: TurnInputItem.Raw[] | null;- state: TurnStateRunning.Raw;-- created_by: Subject.Raw;-+ created_by?: Subject.Raw | null;- created_at: string;- thread_id?: string | null;- }-diff --git a/dist/cjs/serialization/types/TurnCreatedEvent.js b/dist/cjs/serialization/types/TurnCreatedEvent.js-index f61ed6f67e6a2db84b1e850d8918b86b96ad9807..8ce0ed45796a4019a1db6026b1674791b05fc92a 100644---- a/dist/cjs/serialization/types/TurnCreatedEvent.js-+++ b/dist/cjs/serialization/types/TurnCreatedEvent.js-@@ -46,7 +46,7 @@ exports.TurnCreatedEvent = core.serialization.object({- previousTurnId: core.serialization.property("previous_turn_id", core.serialization.string().optional()),- input: core.serialization.list(TurnInputItem_js_1.TurnInputItem).optional(),- state: TurnStateRunning_js_1.TurnStateRunning,-- createdBy: core.serialization.property("created_by", Subject_js_1.Subject),-+ createdBy: core.serialization.property("created_by", Subject_js_1.Subject.optional()),- createdAt: core.serialization.property("created_at", core.serialization.string()),- threadId: core.serialization.property("thread_id", core.serialization.string().optional()),- });-diff --git a/dist/esm/api/types/TurnCreatedEvent.d.mts b/dist/esm/api/types/TurnCreatedEvent.d.mts-index f0bb125d2eeccc2b23b0256a91d395a8a8641b55..7a5f70c8cc614c98f1e3c06d8294cca616f1709f 100644---- a/dist/esm/api/types/TurnCreatedEvent.d.mts-+++ b/dist/esm/api/types/TurnCreatedEvent.d.mts-@@ -7,7 +7,7 @@ export interface TurnCreatedEvent {- previousTurnId?: string;- input?: TrueFoundryGateway.TurnInputItem[];- state: TrueFoundryGateway.TurnStateRunning;-- createdBy: TrueFoundryGateway.Subject;-+ createdBy?: TrueFoundryGateway.Subject;- createdAt: string;- threadId?: string;- }-diff --git a/dist/esm/serialization/types/TurnCreatedEvent.d.mts b/dist/esm/serialization/types/TurnCreatedEvent.d.mts-index d55a14dda8ba0c7ab3fdb1c0a4228c7c9c58abc8..99590e0c4833a29742d6c22568846b26761e9693 100644---- a/dist/esm/serialization/types/TurnCreatedEvent.d.mts-+++ b/dist/esm/serialization/types/TurnCreatedEvent.d.mts-@@ -13,7 +13,7 @@ export declare namespace TurnCreatedEvent {- previous_turn_id?: string | null;- input?: TurnInputItem.Raw[] | null;- state: TurnStateRunning.Raw;-- created_by: Subject.Raw;-+ created_by?: Subject.Raw | null;- created_at: string;- thread_id?: string | null;- }-diff --git a/dist/esm/serialization/types/TurnCreatedEvent.mjs b/dist/esm/serialization/types/TurnCreatedEvent.mjs-index f83da50aa6b211d84a4f0f79828e908d11582535..cd145ee488e035d83a2067acd73aef4c82c75bde 100644---- a/dist/esm/serialization/types/TurnCreatedEvent.mjs-+++ b/dist/esm/serialization/types/TurnCreatedEvent.mjs-@@ -10,7 +10,7 @@ export const TurnCreatedEvent = core.serialization.object({- previousTurnId: core.serialization.property("previous_turn_id", core.serialization.string().optional()),- input: core.serialization.list(TurnInputItem).optional(),- state: TurnStateRunning,-- createdBy: core.serialization.property("created_by", Subject),-+ createdBy: core.serialization.property("created_by", Subject.optional()),- createdAt: core.serialization.property("created_at", core.serialization.string()),- threadId: core.serialization.property("thread_id", core.serialization.string().optional()),- });diff --git a/patches/[email protected] b/patches/[email protected]new file mode 100644index 000000000..b7c14ddd6--- /dev/null+++ b/patches/[email protected]@@ -0,0 +1,138 @@+diff --git a/dist/cjs/api/types/TurnCreatedEvent.d.ts b/dist/cjs/api/types/TurnCreatedEvent.d.ts+--- a/dist/cjs/api/types/TurnCreatedEvent.d.ts++++ b/dist/cjs/api/types/TurnCreatedEvent.d.ts+@@ -7,7 +7,7 @@+ previousTurnId?: string | null;+ input?: TrueFoundryGateway.TurnInputItem[];+ state: TrueFoundryGateway.TurnStateRunning;+- createdBy: TrueFoundryGateway.Subject;++ createdBy?: TrueFoundryGateway.Subject;+ createdAt: string;+ threadId?: string | null;+ }+diff --git a/dist/cjs/serialization/types/TurnCreatedEvent.d.ts b/dist/cjs/serialization/types/TurnCreatedEvent.d.ts+--- a/dist/cjs/serialization/types/TurnCreatedEvent.d.ts++++ b/dist/cjs/serialization/types/TurnCreatedEvent.d.ts+@@ -13,7 +13,7 @@+ previous_turn_id?: (string | null | undefined) | null;+ input?: TurnInputItem.Raw[] | null;+ state: TurnStateRunning.Raw;+- created_by: Subject.Raw;++ created_by?: Subject.Raw | null;+ created_at: string;+ thread_id?: (string | null | undefined) | null;+ }+diff --git a/dist/cjs/serialization/types/TurnCreatedEvent.js b/dist/cjs/serialization/types/TurnCreatedEvent.js+--- a/dist/cjs/serialization/types/TurnCreatedEvent.js++++ b/dist/cjs/serialization/types/TurnCreatedEvent.js+@@ -46,7 +46,7 @@+ previousTurnId: core.serialization.property("previous_turn_id", core.serialization.string().optionalNullable()),+ input: core.serialization.list(TurnInputItem_js_1.TurnInputItem).optional(),+ state: TurnStateRunning_js_1.TurnStateRunning,+- createdBy: core.serialization.property("created_by", Subject_js_1.Subject),++ createdBy: core.serialization.property("created_by", Subject_js_1.Subject.optional()),+ createdAt: core.serialization.property("created_at", core.serialization.string()),+ threadId: core.serialization.property("thread_id", core.serialization.string().optionalNullable()),+ });+diff --git a/dist/esm/api/types/TurnCreatedEvent.d.mts b/dist/esm/api/types/TurnCreatedEvent.d.mts+--- a/dist/esm/api/types/TurnCreatedEvent.d.mts++++ b/dist/esm/api/types/TurnCreatedEvent.d.mts+@@ -7,7 +7,7 @@+ previousTurnId?: string | null;+ input?: TrueFoundryGateway.TurnInputItem[];+ state: TrueFoundryGateway.TurnStateRunning;+- createdBy: TrueFoundryGateway.Subject;++ createdBy?: TrueFoundryGateway.Subject;+ createdAt: string;+ threadId?: string | null;+ }+diff --git a/dist/esm/serialization/types/TurnCreatedEvent.d.mts b/dist/esm/serialization/types/TurnCreatedEvent.d.mts+--- a/dist/esm/serialization/types/TurnCreatedEvent.d.mts++++ b/dist/esm/serialization/types/TurnCreatedEvent.d.mts+@@ -13,7 +13,7 @@+ previous_turn_id?: (string | null | undefined) | null;+ input?: TurnInputItem.Raw[] | null;+ state: TurnStateRunning.Raw;+- created_by: Subject.Raw;++ created_by?: Subject.Raw | null;+ created_at: string;+ thread_id?: (string | null | undefined) | null;+ }+diff --git a/dist/esm/serialization/types/TurnCreatedEvent.mjs b/dist/esm/serialization/types/TurnCreatedEvent.mjs+--- a/dist/esm/serialization/types/TurnCreatedEvent.mjs++++ b/dist/esm/serialization/types/TurnCreatedEvent.mjs+@@ -10,7 +10,7 @@+ previousTurnId: core.serialization.property("previous_turn_id", core.serialization.string().optionalNullable()),+ input: core.serialization.list(TurnInputItem).optional(),+ state: TurnStateRunning,+- createdBy: core.serialization.property("created_by", Subject),++ createdBy: core.serialization.property("created_by", Subject.optional()),+ createdAt: core.serialization.property("created_at", core.serialization.string()),+ threadId: core.serialization.property("thread_id", core.serialization.string().optionalNullable()),+ });+diff --git a/dist/cjs/api/types/GitSourceSkillMount.d.ts b/dist/cjs/api/types/GitSourceSkillMount.d.ts+--- a/dist/cjs/api/types/GitSourceSkillMount.d.ts++++ b/dist/cjs/api/types/GitSourceSkillMount.d.ts+@@ -6,6 +6,8 @@+ path?: string;+ /** Name for the skill, used as directory name in sandbox. */+ name: string;++ /** Concise guidance for when the agent should use the skill. */++ description: string;+ /** Git ref — branch name, tag, or commit SHA. */+ ref: string;+ }+diff --git a/dist/cjs/serialization/types/GitSourceSkillMount.d.ts b/dist/cjs/serialization/types/GitSourceSkillMount.d.ts+--- a/dist/cjs/serialization/types/GitSourceSkillMount.d.ts++++ b/dist/cjs/serialization/types/GitSourceSkillMount.d.ts+@@ -8,6 +8,7 @@+ url: string;+ path?: string | null;+ name: string;++ description: string;+ ref: string;+ }+ }+diff --git a/dist/cjs/serialization/types/GitSourceSkillMount.js b/dist/cjs/serialization/types/GitSourceSkillMount.js+--- a/dist/cjs/serialization/types/GitSourceSkillMount.js++++ b/dist/cjs/serialization/types/GitSourceSkillMount.js+@@ -41,5 +41,6 @@+ url: core.serialization.string(),+ path: core.serialization.string().optional(),+ name: core.serialization.string(),++ description: core.serialization.string(),+ ref: core.serialization.string(),+ });+diff --git a/dist/esm/api/types/GitSourceSkillMount.d.mts b/dist/esm/api/types/GitSourceSkillMount.d.mts+--- a/dist/esm/api/types/GitSourceSkillMount.d.mts++++ b/dist/esm/api/types/GitSourceSkillMount.d.mts+@@ -6,6 +6,8 @@+ path?: string;+ /** Name for the skill, used as directory name in sandbox. */+ name: string;++ /** Concise guidance for when the agent should use the skill. */++ description: string;+ /** Git ref — branch name, tag, or commit SHA. */+ ref: string;+ }+diff --git a/dist/esm/serialization/types/GitSourceSkillMount.d.mts b/dist/esm/serialization/types/GitSourceSkillMount.d.mts+--- a/dist/esm/serialization/types/GitSourceSkillMount.d.mts++++ b/dist/esm/serialization/types/GitSourceSkillMount.d.mts+@@ -8,6 +8,7 @@+ url: string;+ path?: string | null;+ name: string;++ description: string;+ ref: string;+ }+ }+diff --git a/dist/esm/serialization/types/GitSourceSkillMount.mjs b/dist/esm/serialization/types/GitSourceSkillMount.mjs+--- a/dist/esm/serialization/types/GitSourceSkillMount.mjs++++ b/dist/esm/serialization/types/GitSourceSkillMount.mjs+@@ -5,5 +5,6 @@+ url: core.serialization.string(),+ path: core.serialization.string().optional(),+ name: core.serialization.string(),++ description: core.serialization.string(),+ ref: core.serialization.string(),+ });diff --git a/pnpm-lock.yaml b/pnpm-lock.yamlindex a187e35e4..63520e964 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -7,11 +7,12 @@ settings:overrides:'@assistant-ui/store': 0.2.20'@assistant-ui/core': 0.2.21+ resolve: 1.22.11packageExtensionsChecksum: sha256-K9nlh0yLSTRsirW8Zz/jRCV+jKDHeXByr3Hh+Mxvsb0=patchedDependencies:- [email protected]: 82397ea3973e26f832a3e2344fa386ac7b33153eabbee0d6450ec7d1fb48022b+ [email protected]: 2dd458ac139d735ffb9d9fadc203e4314f0a0f0c7338c365cc0bb4b4f4c8f6b4importers:@@ -58,10 +59,10 @@ importers:version: 0.2.20(@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected])'@truefoundry/agent-ui-sdk':specifier: 0.0.8- version: 0.0.8(3e21b3c1846eeb3a5891f21a03e154c4)+ version: 0.0.8(f645c8c3699fdf377e27e4913e1bf82b)'@truefoundry/assistant-ui-runtime':specifier: 0.1.4- version: 0.1.4(@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected])([email protected])([email protected](patch_hash=82397ea3973e26f832a3e2344fa386ac7b33153eabbee0d6450ec7d1fb48022b))([email protected](@types/[email protected])([email protected])([email protected]([email protected])))+ version: 0.1.4(@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected])([email protected])([email protected](patch_hash=2dd458ac139d735ffb9d9fadc203e4314f0a0f0c7338c365cc0bb4b4f4c8f6b4))([email protected](@types/[email protected])([email protected])([email protected]([email protected])))monaco-editor:specifier: ^0.52.0version: 0.52.2@@ -75,8 +76,8 @@ importers:specifier: ^0.0.31version: 0.0.31(4764be86a9d6d6cfa9a2d08252009a0c)truefoundry-gateway-sdk:- specifier: 0.4.0-rc.1- version: 0.4.0-rc.1(patch_hash=82397ea3973e26f832a3e2344fa386ac7b33153eabbee0d6450ec7d1fb48022b)+ specifier: 0.4.0-rc.2+ version: 0.4.0-rc.2(patch_hash=2dd458ac139d735ffb9d9fadc203e4314f0a0f0c7338c365cc0bb4b4f4c8f6b4)devDependencies:'@types/react':specifier: ^19.2.17@@ -90,6 +91,9 @@ importers:playwright-core:specifier: ^1.61.1version: 1.61.1+ tsx:+ specifier: ^4.16.2+ version: 4.23.1typescript:specifier: ^5.9.3version: 5.9.3@@ -5421,8 +5425,8 @@ packages:resolution: {integrity: sha512-OcXjMsGdhL4XnbShKpAcSqPMzQoYkYyhbEaeSko47MjRP9NfEQMhZkXL1DoFlt9LWQn4YttrdnV6X2OiyzBi+A==}engines: {node: '>=10'}- resolution: {integrity: sha512-TyeJ1zif53BPfHootBGwPRYT1RUt6oGWsaQr8UyZW/eAm9bKoijtvruSDEmZHm92CwS9nj7/fWttqPCgzep8CA==}+ resolution: {integrity: sha512-RfqAvLnMl313r7c9oclB1HhUEAezcpLjz95wFH4LVuhk9JF/r22qmVP9AMmOU4vMX7Q8pN8jwNg/CSpdFnMjTQ==}engines: {node: '>= 0.4'}hasBin: true@@ -5752,8 +5756,8 @@ packages:resolution: {integrity: sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==}- resolution: {integrity: sha512-ITDPaChDp2EccgRdOjfn22OmYFA5XdXQnhQWPGj6Hhr0jhPfkNz/YQrt9cFCTCXAfVP9N+3vVZVhwRagfjN/Jg==}+ resolution: {integrity: sha512-sQllg/uww1tsH3bhwt6B/+TpAXizd+xwvML3Ak+HMd1rwDEHWBFBJ43c1uDHVBEwosvx1YtZhJX3uwSyAqsASg==}engines: {node: '>=18.0.0'}@@ -8924,7 +8928,7 @@ snapshots:'@tabby_ai/[email protected]': {}- '@truefoundry/[email protected](3e21b3c1846eeb3a5891f21a03e154c4)':+ '@truefoundry/[email protected](f645c8c3699fdf377e27e4913e1bf82b)':dependencies:'@assistant-ui/core': 0.2.21(@assistant-ui/[email protected](@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected]))(@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected])([email protected])([email protected](@types/[email protected])([email protected])([email protected]([email protected])))'@assistant-ui/react': 0.14.27(@types/[email protected](@types/[email protected]))(@types/[email protected])([email protected]([email protected]))([email protected])([email protected]([email protected]))@@ -8937,7 +8941,7 @@ snapshots:'@openuidev/react-headless': 0.9.3([email protected])([email protected](@types/[email protected])([email protected])([email protected]([email protected])))'@openuidev/react-lang': 0.2.8(@modelcontextprotocol/[email protected]([email protected])([email protected]))([email protected])([email protected])'@openuidev/react-ui': 0.12.1(@openuidev/[email protected]([email protected])([email protected](@types/[email protected])([email protected])([email protected]([email protected]))))(@openuidev/[email protected](@modelcontextprotocol/[email protected]([email protected])([email protected]))([email protected])([email protected]))(@types/[email protected](@types/[email protected]))(@types/[email protected])([email protected]([email protected]))([email protected])([email protected])([email protected])([email protected](@types/[email protected])([email protected])([email protected]([email protected])))- '@truefoundry/assistant-ui-runtime': 0.1.4(@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected])([email protected])([email protected](patch_hash=82397ea3973e26f832a3e2344fa386ac7b33153eabbee0d6450ec7d1fb48022b))([email protected](@types/[email protected])([email protected])([email protected]([email protected])))+ '@truefoundry/assistant-ui-runtime': 0.1.4(@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected])([email protected])([email protected](patch_hash=2dd458ac139d735ffb9d9fadc203e4314f0a0f0c7338c365cc0bb4b4f4c8f6b4))([email protected](@types/[email protected])([email protected])([email protected]([email protected])))class-variance-authority: 0.7.1classnames: 2.5.1clsx: 2.1.1@@ -8950,7 +8954,7 @@ snapshots:remark-gfm: 4.0.1([email protected])tailwind-merge: 3.6.0tfy-web-components: 0.0.31(4764be86a9d6d6cfa9a2d08252009a0c)- truefoundry-gateway-sdk: 0.4.0-rc.1(patch_hash=82397ea3973e26f832a3e2344fa386ac7b33153eabbee0d6450ec7d1fb48022b)+ truefoundry-gateway-sdk: 0.4.0-rc.2(patch_hash=2dd458ac139d735ffb9d9fadc203e4314f0a0f0c7338c365cc0bb4b4f4c8f6b4)optionalDependencies:'@types/react': 19.2.17transitivePeerDependencies:@@ -8961,12 +8965,12 @@ snapshots:- zod- zustand- '@truefoundry/[email protected](@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected])([email protected])([email protected](patch_hash=82397ea3973e26f832a3e2344fa386ac7b33153eabbee0d6450ec7d1fb48022b))([email protected](@types/[email protected])([email protected])([email protected]([email protected])))':+ '@truefoundry/[email protected](@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected])([email protected])([email protected](patch_hash=2dd458ac139d735ffb9d9fadc203e4314f0a0f0c7338c365cc0bb4b4f4c8f6b4))([email protected](@types/[email protected])([email protected])([email protected]([email protected])))':dependencies:'@assistant-ui/core': 0.2.21(@assistant-ui/[email protected](@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected]))(@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected])([email protected])([email protected](@types/[email protected])([email protected])([email protected]([email protected])))'@assistant-ui/store': 0.2.20(@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected])react: 19.2.8- truefoundry-gateway-sdk: 0.4.0-rc.1(patch_hash=82397ea3973e26f832a3e2344fa386ac7b33153eabbee0d6450ec7d1fb48022b)+ truefoundry-gateway-sdk: 0.4.0-rc.2(patch_hash=2dd458ac139d735ffb9d9fadc203e4314f0a0f0c7338c365cc0bb4b4f4c8f6b4)optionalDependencies:'@types/react': 19.2.17transitivePeerDependencies:@@ -9425,7 +9429,7 @@ snapshots:dependencies:'@babel/runtime': 7.29.7cosmiconfig: 7.1.0- resolve: 1.22.12+ resolve: 1.22.11dependencies:@@ -10856,7 +10860,7 @@ snapshots:jest-pnp-resolver: 1.2.3([email protected])jest-util: 29.7.0jest-validate: 29.7.0- resolve: 1.22.12+ resolve: 1.22.11resolve.exports: 2.0.3slash: 3.0.0@@ -11755,7 +11759,7 @@ snapshots:postcss: 8.5.22postcss-value-parser: 4.2.0read-cache: 1.0.0- resolve: 1.22.12+ resolve: 1.22.11dependencies:@@ -12223,9 +12227,8 @@ snapshots:dependencies:- es-errors: 1.3.0is-core-module: 2.16.2path-parse: 1.0.7supports-preserve-symlinks-flag: 1.0.0@@ -12528,7 +12531,7 @@ snapshots:postcss-load-config: 4.0.2([email protected])postcss-nested: 6.2.0([email protected])postcss-selector-parser: 6.1.4- resolve: 1.22.12+ resolve: 1.22.11sucrase: 3.35.1transitivePeerDependencies:- ts-node@@ -12611,7 +12614,7 @@ snapshots:- [email protected](patch_hash=82397ea3973e26f832a3e2344fa386ac7b33153eabbee0d6450ec7d1fb48022b): {}+ [email protected](patch_hash=2dd458ac139d735ffb9d9fadc203e4314f0a0f0c7338c365cc0bb4b4f4c8f6b4): {}dependencies:diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yamlindex 422b89abf..30402d25b 100644--- a/pnpm-workspace.yaml+++ b/pnpm-workspace.yaml@@ -13,12 +13,14 @@ allowBuilds:peerDependencyRules:allowedVersions:'@truefoundry/assistant-ui-runtime': '0.1.4'- truefoundry-gateway-sdk: '0.4.0-rc.1'+ truefoundry-gateway-sdk: '0.4.0-rc.2'# One Context module for assistant-ui (avoids "requires an AuiProvider").overrides:'@assistant-ui/store': '0.2.20''@assistant-ui/core': '0.2.21'+ # [email protected] ships accidental .claude/ files that break installs under macOS sandbox.+ resolve: '1.22.11'# tfy-web-components imports packages it does not declare (breaks Vite/pnpm resolution).packageExtensions:@@ -34,4 +36,4 @@ packageExtensions:tailwind-merge: '^2.6.0'patchedDependencies:- [email protected]: patches/[email protected]+ [email protected]: patches/[email protected]