Skip to content

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.mjs
index 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.json
index 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.json
index 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.tsx
index 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.tsx
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
deleted file mode 100644
index 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.json
index 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.ts
index 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.ts
index 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.py
index 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 a
small 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 stripped
class 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 an
option/argument. Fetching by object id relies on the server allowing it, which github.com and
gitlab.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.path
return
state.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 False
return 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.path
for 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 the
rest 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 are
missing, 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 = 0
for 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 += 1
else:
- 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 += 1
except 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 satisfied
diff --git a/packages/harness/src/core/sandbox/skills/SkillMounter.ts b/packages/harness/src/core/sandbox/skills/SkillMounter.ts
index 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.ts
new file mode 100644
index 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.ts
index 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.json
index 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.yaml
index 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 skill
skills:
- - 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.ts
index 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.ts
index 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.ts
index 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 }): TurnSandbo
logger,
});
- // 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.ts
index a1bf5cd32..2aebfa804 100644
--- a/packages/server/src/store/schemas.ts
+++ b/packages/server/src/store/schemas.ts
@@ -88,9 +88,9 @@ export const SkillEntrySchema = z
url: 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.json
index 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 100644
index 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 100644
index 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.yaml
index 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.11
packageExtensionsChecksum: sha256-K9nlh0yLSTRsirW8Zz/jRCV+jKDHeXByr3Hh+Mxvsb0=
patchedDependencies:
- [email protected]: 82397ea3973e26f832a3e2344fa386ac7b33153eabbee0d6450ec7d1fb48022b
+ [email protected]: 2dd458ac139d735ffb9d9fadc203e4314f0a0f0c7338c365cc0bb4b4f4c8f6b4
importers:
@@ -58,10 +59,10 @@ importers:
'@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.0
version: 0.52.2
@@ -75,8 +76,8 @@ importers:
specifier: ^0.0.31
version: 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.1
version: 1.61.1
+ tsx:
+ specifier: ^4.16.2
+ version: 4.23.1
typescript:
specifier: ^5.9.3
version: 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:
@@ -8937,7 +8941,7 @@ snapshots:
'@openuidev/react-lang': 0.2.8(@modelcontextprotocol/[email protected]([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.1
classnames: 2.5.1
clsx: 2.1.1
@@ -8950,7 +8954,7 @@ snapshots:
remark-gfm: 4.0.1([email protected])
tailwind-merge: 3.6.0
tfy-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.17
transitivePeerDependencies:
@@ -8961,12 +8965,12 @@ snapshots:
- zod
- zustand
dependencies:
'@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.17
transitivePeerDependencies:
@@ -9425,7 +9429,7 @@ snapshots:
dependencies:
'@babel/runtime': 7.29.7
cosmiconfig: 7.1.0
- resolve: 1.22.12
+ resolve: 1.22.11
dependencies:
@@ -10856,7 +10860,7 @@ snapshots:
jest-pnp-resolver: 1.2.3([email protected])
jest-util: 29.7.0
jest-validate: 29.7.0
- resolve: 1.22.12
+ resolve: 1.22.11
resolve.exports: 2.0.3
slash: 3.0.0
@@ -11755,7 +11759,7 @@ snapshots:
postcss: 8.5.22
postcss-value-parser: 4.2.0
read-cache: 1.0.0
- resolve: 1.22.12
+ resolve: 1.22.11
dependencies:
@@ -12223,9 +12227,8 @@ snapshots:
dependencies:
- es-errors: 1.3.0
is-core-module: 2.16.2
path-parse: 1.0.7
supports-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.11
sucrase: 3.35.1
transitivePeerDependencies:
- 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.yaml
index 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: