@codeworksh/harness 0.3.0-dev.20261013131320 → 0.3.0-dev.20261019181702

package/effect.mjs

@@ -1,7 +1,7 @@
 import { n as __reExport, t as __exportAll } from "./rolldown-runtime-B4FMCO8f.mjs";
 import { a as io_exports, i as errors_exports, n as shell_exports, o as instance_exports, r as filesystem_exports, s as posix } from "./resource-DFZh0e-s.mjs";
 import { a as decode, c as importModule, d as share, l as lendResolve, n as dimensionNote, o as load$5, r as resize, s as load$4, u as resolveModule } from "./resize-D34zcVQl.mjs";
-import "./daytona-D4sNwzSr.mjs";
+import "./daytona-BqRoRhe7.mjs";
 import "./vercel-3GouQSJI.mjs";
 import { createRequire } from "node:module";
 import { Cause, Clock, Config, Context, Crypto, Data, DateTime, Deferred, Duration, Effect, Exit, Fiber, FiberSet, FileSystem, Layer, LayerMap, Metric, Option, Path, Predicate, PubSub, Queue, Random, Ref, Result, Schedule, Schema, SchemaIssue, Scope, Semaphore, Stream, String as String$1 } from "effect";
@@ -21,11 +21,13 @@ import { ChildProcess, ChildProcessSpawner } from "effect/process";
 import { Buffer as Buffer$1 } from "node:buffer";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { DirectoryNotFoundError, DirectoryNotFoundError as DirectoryNotFoundError$1, Info, Info as Info$1, NotDirectoryError, NotDirectoryError as NotDirectoryError$1, Service, Service as Service$8 } from "@codeworksh/plugin/location";
-import { generateModels } from "@codeworksh/aikit/modelgen";
+import { downloadCatalog } from "@codeworksh/aikit/modelgen";
 import { JsonGitHubCopilotAuthStorage, getGitHubCopilotApiKey } from "@codeworksh/aikit/oauth/github/copilot";
 import { JsonOpenAICodexAuthStorage, getOpenAICodexApiKey } from "@codeworksh/aikit/oauth/openai/codex";
 import { parse, printParseErrorCode } from "jsonc-parser";
 import * as Section from "@codeworksh/plugin/plugin/section";
+import ignore from "ignore";
+import { parse as parse$1 } from "yaml";
 import * as Diff from "diff";
 import { FetchHttpClient, HttpClient } from "effect/http";
 import npa from "npm-package-arg";
@@ -134,10 +136,10 @@ var global_exports = /* @__PURE__ */ __exportAll({
 	app: () => app,
 	appConfigDir: () => appConfigDir,
 	authFile: () => authFile,
-	defaultLayer: () => defaultLayer$2,
+	defaultLayer: () => defaultLayer$4,
 	homeConfig: () => homeConfig,
 	layer: () => layer$27,
-	layerWith: () => layerWith,
+	layerWith: () => layerWith$1,
 	make: () => make$18,
 	resolve: () => resolve$4
 });
@@ -184,8 +186,8 @@ const build = (input) => Effect.gen(function* () {
 	return Service$17.of(paths);
 });
 const layer$27 = Layer.effect(Service$17, build({}));
-const defaultLayer$2 = layer$27;
-const layerWith = (input) => Layer.effect(Service$17, build(input));
+const defaultLayer$4 = layer$27;
+const layerWith$1 = (input) => Layer.effect(Service$17, build(input));
 //#endregion
 //#region src/db/migrations.ts
 const migrations = {
@@ -374,7 +376,7 @@ var db_exports = /* @__PURE__ */ __exportAll({
 	Database: () => db_exports,
 	SqlClient: () => SqlClient$1,
 	SqlSchema: () => SqlSchema$1,
-	defaultLayer: () => defaultLayer$1,
+	defaultLayer: () => defaultLayer$3,
 	layer: () => layer$26,
 	locationConfig: () => locationConfig,
 	path: () => path$1,
@@ -408,7 +410,7 @@ const path$1 = Effect.fn("Database.path")(function* (data) {
 	const directory = data ?? (yield* resolve$4()).data;
 	return resolveDatabaseLocation(yield* locationConfig, directory);
 });
-const defaultLayer$1 = Layer.unwrap(path$1().pipe(Effect.map(layer$26)));
+const defaultLayer$3 = Layer.unwrap(path$1().pipe(Effect.map(layer$26)));
 //#endregion
 //#region src/event/schema.ts
 var schema_exports$7 = /* @__PURE__ */ __exportAll({});
@@ -1579,7 +1581,7 @@ var session_exports$1 = /* @__PURE__ */ __exportAll({
 	SessionNotLinkedError: () => SessionNotLinkedError,
 	SessionRow: () => SessionRow,
 	ToolCallNotFoundError: () => ToolCallNotFoundError,
-	defaultLayer: () => defaultLayer,
+	defaultLayer: () => defaultLayer$2,
 	entryStates: () => entryStates,
 	entryTypes: () => entryTypes,
 	layer: () => layer$23,
@@ -1663,6 +1665,16 @@ const layer$23 = Layer.effect(Service$14, Effect.gen(function* () {
 				SELECT p.* FROM space p JOIN session s ON s.space_id = p.id WHERE s.id = ${sessionId}
 			`
 	});
+	const findProject = SqlSchema.findOneOption({
+		Request: Schema.String,
+		Result: ProjectRow,
+		execute: (sessionId) => sql`
+				SELECT p.* FROM project p
+				JOIN space sp ON sp.project_id = p.id
+				JOIN session s ON s.space_id = sp.id
+				WHERE s.id = ${sessionId}
+			`
+	});
 	const findSpaceById = SqlSchema.findOneOption({
 		Request: Schema.String,
 		Result: SpaceRow,
@@ -1811,6 +1823,13 @@ const layer$23 = Layer.effect(Service$14, Effect.gen(function* () {
 	const space = Effect.fn("Session.space")(function* (sessionId) {
 		return Option.map(yield* findSpace(sessionId).pipe(Effect.orDie), fromRow$1);
 	});
+	const project = Effect.fn("Session.project")(function* (sessionId) {
+		return Option.map(yield* findProject(sessionId).pipe(Effect.orDie), (row) => new schema_exports$6.ProjectSchema.Info({
+			id: schema_exports$6.ProjectSchema.ID.make(row.id),
+			name: row.name,
+			status: row.status
+		}));
+	});
 	const list = Effect.fn("Session.list")(function* (input) {
 		return yield* (input === void 0 ? selectAll() : "spaceId" in input ? selectBySpace(input.spaceId) : selectByProject(input.projectId)).pipe(Effect.orDie);
 	});
@@ -2313,6 +2332,7 @@ const layer$23 = Layer.effect(Service$14, Effect.gen(function* () {
 		configure,
 		get,
 		space,
+		project,
 		list,
 		entry,
 		path,
@@ -2329,7 +2349,7 @@ const layer$23 = Layer.effect(Service$14, Effect.gen(function* () {
 		setLabel
 	});
 }));
-const defaultLayer = layer$23.pipe(Layer.provide(defaultLayer$1));
+const defaultLayer$2 = layer$23.pipe(Layer.provide(defaultLayer$3));
 //#endregion
 //#region src/context/errors.ts
 var ContextDecodeError = class extends Schema.TaggedError()("ContextDecodeError", {
@@ -4274,6 +4294,17 @@ const make$9 = () => {
 	}) };
 };
 //#endregion
+//#region src/sandbox/sandbox.ts
+/**
+* Assemble a local backend into a sandbox with a **real host shell** — the
+* right choice whenever commands must invoke actual binaries (`git`, package
+* managers). For a sandbox whose shell should stay inside the VFS, use
+* `EnvBash.services` instead, which wires just-bash over the same tree.
+*/
+const services = (backend, identity) => Layer.provideMerge(io_exports.SandboxIO.mount(identity), Layer.provideMerge(Layer.merge(layer$21, layer$18()), backend));
+/** Default sandbox: the real OS filesystem and processes, mounted at `cwd`. */
+const defaultLayer$1 = (cwd) => services(layer$20(), io_exports.SandboxIO.host(cwd));
+//#endregion
 //#region src/git/git.ts
 var AppProcessError = class extends Schema.TaggedError()("AppProcessError", {
 	command: Schema.String,
@@ -4464,7 +4495,8 @@ const up = Effect.fn("SandboxFileSystem.up")(function* (fs, options) {
 const isDirectory$1 = Effect.fn("SandboxFileSystem.isDirectory")(function* (fs, path) {
 	return yield* fs.stat(path).pipe(Effect.map((stat) => stat.isDirectory), Effect.orElseSucceed(() => false));
 });
-Effect.fn("SandboxFileSystem.isFile")(function* (fs, path) {
+/** True when `path` exists and is a regular file; false when it is absent or unreadable. */
+const isFile = Effect.fn("SandboxFileSystem.isFile")(function* (fs, path) {
 	return yield* fs.stat(path).pipe(Effect.map((stat) => stat.isFile), Effect.orElseSucceed(() => false));
 });
 /** Read a file, or `undefined` when it is missing or unreadable. */
@@ -4611,6 +4643,16 @@ const layer$13 = Layer.effect(Service$10, Effect.gen(function* () {
 }));
 //#endregion
 //#region src/project/project.ts
+var project_exports = /* @__PURE__ */ __exportAll({
+	Project: () => project_exports,
+	ProjectNotFoundError: () => ProjectNotFoundError,
+	Service: () => Service$9,
+	defaultLayer: () => defaultLayer,
+	layer: () => layer$12,
+	layerWith: () => layerWith,
+	provisional: () => provisional,
+	rename: () => rename
+});
 /** Deterministic, env-local id for a directory without a portable identity. Never written to a marker. */
 const provisional = (env, location) => schema_exports$6.ProjectSchema.ID.make(fast(JSON.stringify([
 	"dir",
@@ -4664,7 +4706,7 @@ const layer$12 = Layer.effect(Service$9, Effect.gen(function* () {
 			main: repo.gitDir === repo.store
 		}]).toSorted((a, b) => Number(b.main) - Number(a.main));
 	});
-	const resolveOrCreate = Effect.fn("Project.resolveOrCreate")(function* (cwd) {
+	const resolveOrCreate = Effect.fn("Project.resolveOrCreate")(function* (cwd, options) {
 		if (!(yield* fs.exists(cwd).pipe(Effect.orDie))) return yield* new DirectoryNotFoundError$1({
 			directory: cwd,
 			sandboxInstanceId: env
@@ -4678,7 +4720,7 @@ const layer$12 = Layer.effect(Service$9, Effect.gen(function* () {
 		const ident = repo === void 0 ? void 0 : yield* repos.identity(repo);
 		const worktree = repo?.directory ?? location;
 		const projectId = ident?.id === void 0 ? provisional(env, worktree) : schema_exports$6.ProjectSchema.ID.make(ident.id);
-		const name = ident?.name ?? posix.basename(worktree);
+		const name = options?.name ?? ident?.name ?? posix.basename(worktree);
 		const vcs = repo === void 0 ? void 0 : {
 			type: "git",
 			store: repo.store
@@ -4750,6 +4792,32 @@ const layer$12 = Layer.effect(Service$9, Effect.gen(function* () {
 		list
 	});
 }));
+var ProjectNotFoundError = class extends Schema.TaggedError()("ProjectNotFoundError", { projectId: Schema.String }) {};
+/** Renames a project. Needs only the database, not a mount: a name is the same in every env. */
+const rename = Effect.fn("Project.rename")(function* (input) {
+	const sql = yield* SqlClient.SqlClient;
+	const now = yield* Effect.clockWith((clock) => clock.currentTimeMillis);
+	const row = yield* SqlSchema.findOneOption({
+		Request: Schema.Struct({
+			id: Schema.String,
+			name: Schema.String
+		}),
+		Result: ProjectRow,
+		execute: ({ id, name }) => sql`UPDATE project SET name = ${name}, updated_at = ${now} WHERE id = ${id} RETURNING *`
+	})({
+		id: input.projectId,
+		name: input.name
+	}).pipe(Effect.orDie);
+	if (Option.isNone(row)) return yield* new ProjectNotFoundError({ projectId: input.projectId });
+	return new schema_exports$6.ProjectSchema.Info({
+		id: schema_exports$6.ProjectSchema.ID.make(row.value.id),
+		name: row.value.name,
+		status: row.value.status
+	});
+});
+/** Takes an assembled sandbox — local or remote — not a local backend. */
+const layerWith = (sandbox) => layer$12.pipe(Layer.provide(Layer.mergeAll(layer$14, layer$13, layer$24)), Layer.provide(layer$15), Layer.provide(sandbox), Layer.provide(defaultLayer$3));
+const defaultLayer = (path) => layerWith(defaultLayer$1(path));
 //#endregion
 //#region src/location/location.ts
 var location_exports = /* @__PURE__ */ __exportAll({
@@ -4761,10 +4829,10 @@ var location_exports = /* @__PURE__ */ __exportAll({
 	layer: () => layer$11,
 	layerMounted: () => layerMounted
 });
-const layer$11 = () => Layer.effect(Service, Effect.gen(function* () {
+const layer$11 = (options) => Layer.effect(Service, Effect.gen(function* () {
 	const instance = yield* io_exports.SandboxIO.Current;
 	const directory = schema_exports$9.AbsolutePath.make(instance.cwd);
-	const resolved = yield* (yield* Service$9).resolveOrCreate(directory);
+	const resolved = yield* (yield* Service$9).resolveOrCreate(directory, options);
 	return Service.of(new Info({
 		directory: resolved.directory,
 		space: resolved.space,
@@ -4776,7 +4844,7 @@ const layer$11 = () => Layer.effect(Service, Effect.gen(function* () {
 * folded in. What remains is exactly the mount and the database — for callers
 * that already hold both, such as the runner and `Session.create`.
 */
-const layerMounted = () => layer$11().pipe(Layer.provide(layer$12.pipe(Layer.provide(Layer.mergeAll(layer$14, layer$13, layer$24)), Layer.provide(layer$15))));
+const layerMounted = (options) => layer$11(options).pipe(Layer.provide(layer$12.pipe(Layer.provide(Layer.mergeAll(layer$14, layer$13, layer$24)), Layer.provide(layer$15))));
 //#endregion
 //#region src/runner/run.ts
 var run_exports = /* @__PURE__ */ __exportAll({
@@ -4871,7 +4939,6 @@ var ProviderError = class extends Schema.TaggedError()("Runner.ProviderError", {
 var ModelCatalogError = class extends Schema.TaggedError()("Runner.ModelCatalogError", {
 	path: Schema.String,
 	reason: Schema.Literals([
-		"missing",
 		"unreadable",
 		"empty",
 		"invalid"
@@ -5312,7 +5379,7 @@ var settings_exports = /* @__PURE__ */ __exportAll({
 	layer: () => layer$8,
 	load: () => load$3,
 	modules: () => modules,
-	parse: () => parse$4,
+	parse: () => parse$5,
 	paths: () => paths,
 	projectRoot: () => projectRoot,
 	userConfigDir: () => userConfigDir
@@ -5401,7 +5468,7 @@ const decodeFormatter = SchemaIssue.makeFormatterStandardSchemaV1({ leafHook: (i
 	const message = "annotations" in issue ? issue.annotations?.message : void 0;
 	return typeof message === "string" ? message.replaceAll(/\s*\n\s*/g, " ") : "invalid value";
 } });
-const parse$4 = Effect.fn("Settings.parse")(function* (path, source) {
+const parse$5 = Effect.fn("Settings.parse")(function* (path, source) {
 	const errors = [];
 	const json = parse(source, errors, {
 		allowTrailingComma: true,
@@ -5449,7 +5516,7 @@ const attempt = (path) => fileSystem.readFileString(path).pipe(Effect.mapError((
 	path,
 	reason: "read",
 	detail: error.reason._tag
-})), Effect.flatMap((source) => parse$4(path, source)));
+})), Effect.flatMap((source) => parse$5(path, source)));
 /**
 * One read of every layer. Exported for the harness constructor, which needs the plugin
 * selection before any layer is built; everything else goes through `Service`.
@@ -5563,8 +5630,13 @@ const stale = Effect.fn("ModelCatalog.stale")(function* (path) {
 	const ttl = yield* ttlConfig;
 	return (yield* Clock.currentTimeMillis) - mtime.value >= Duration.toMillis(ttl);
 });
+/** OpenRouter's catalog is narrowed to what the host's key may use, when one is set. */
+const openRouterKey = () => getEnvApiKey({ env: ["OPENROUTER_API_KEY"] });
 const download$1 = (path) => Effect.tryPromise({
-	try: () => generateModels({ path }),
+	try: () => downloadCatalog({
+		path,
+		openRouterKey: openRouterKey()
+	}),
 	catch: (cause) => new RefreshError({
 		path,
 		detail: cause instanceof Error ? cause.message : String(cause)
@@ -5585,8 +5657,7 @@ const refresh$1 = Effect.fn("ModelCatalog.refresh")(function* (home, options = {
 });
 /**
 * The automatic check: refresh a stale catalog unless it is pinned, and never fail. A failed
-* download leaves the old file in place; a missing one surfaces later as a
-* `Runner.ModelCatalogError` from whatever needed it.
+* download leaves the old file in place; without one, aikit's bundled baseline is read.
 */
 const check$1 = Effect.fn("ModelCatalog.check")(function* ({ path, pinned }) {
 	if (pinned || !(yield* stale(path))) return;
@@ -5622,7 +5693,7 @@ const loadError = (cause) => {
 	if (typeof cause !== "object" || cause === null || !("name" in cause) || cause.name !== "ModelCatalogLoadError") return;
 	if (!("data" in cause) || typeof cause.data !== "object" || cause.data === null) return void 0;
 	const data = cause.data;
-	if (!("path" in data) || typeof data.path !== "string" || !("message" in data) || typeof data.message !== "string" || !("reason" in data) || data.reason !== "missing" && data.reason !== "unreadable" && data.reason !== "empty" && data.reason !== "invalid") return;
+	if (!("path" in data) || typeof data.path !== "string" || !("message" in data) || typeof data.message !== "string" || !("reason" in data) || data.reason !== "unreadable" && data.reason !== "empty" && data.reason !== "invalid") return;
 	return new ModelCatalogError({
 		path: data.path,
 		reason: data.reason,
@@ -5755,6 +5826,22 @@ const defaultPromptPlugin = (0, plugin_exports$1.define)({
 	})
 });
 //#endregion
+//#region src/plugin/builtin/prompt/walk.ts
+const stripBom$1 = (raw) => raw.charCodeAt(0) === 65279 ? raw.slice(1) : raw;
+/** `directory` and every ancestor up to the sandbox root, closest first. */
+const ancestors = (directory) => {
+	const chain = [];
+	for (let current = directory;; current = posix.dirname(current)) {
+		chain.push(current);
+		if (posix.dirname(current) === current) return chain;
+	}
+};
+/**
+* Which of `paths` exist as the requested kind (`entry` takes either). Absence stays silent; any other failure
+* (permissions, a remote blip) is logged so a dropped entry is not a mystery, then counts as absent.
+*/
+const present$1 = (fs, paths, kind, label) => Effect.forEach(paths, (path) => fs.exists(path).pipe(Effect.filterOrElse((exists) => !exists || kind === "entry", () => fs.stat(path).pipe(Effect.map((stat) => kind === "file" ? stat.isFile : stat.isDirectory))), Effect.catch((error) => filesystem_exports.SandboxFileSystem.isNotFoundError(error.cause) ? Effect.succeed(false) : Effect.logWarning(`could not stat ${label} ${path}`, error.cause).pipe(Effect.as(false)))), { concurrency: "unbounded" }).pipe(Effect.map((hits) => new Set(paths.filter((_, index) => hits[index]))));
+//#endregion
 //#region src/plugin/builtin/prompt/instruction.ts
 /** First readable match per directory wins. */
 const names = [
@@ -5766,22 +5853,9 @@ const names = [
 	"CLAUDE.MD"
 ];
 const content = (raw) => {
-	const text = raw.charCodeAt(0) === 65279 ? raw.slice(1) : raw;
+	const text = stripBom$1(raw);
 	return text.trim().length === 0 ? void 0 : text;
 };
-/** `directory` and every ancestor up to the sandbox root, closest first. */
-const ancestors = (directory) => {
-	const chain = [];
-	for (let current = directory;; current = posix.dirname(current)) {
-		chain.push(current);
-		if (posix.dirname(current) === current) return chain;
-	}
-};
-/**
-* Which of `paths` are files. Absence is the expected answer and stays silent; any other failure
-* (permissions, a remote blip) is logged so a dropped file is not a mystery, then counts as absent.
-*/
-const present$1 = (fs, paths) => Effect.forEach(paths, (path) => fs.exists(path).pipe(Effect.flatMap((exists) => exists ? fs.stat(path).pipe(Effect.map((stat) => stat.isFile)) : Effect.succeed(false)), Effect.catch((error) => filesystem_exports.SandboxFileSystem.isNotFoundError(error.cause) ? Effect.succeed(false) : Effect.logWarning(`could not stat instruction file ${path}`, error.cause).pipe(Effect.as(false)))), { concurrency: "unbounded" }).pipe(Effect.map((hits) => new Set(paths.filter((_, index) => hits[index]))));
 /** A file that stats but does not read falls through to the next candidate. */
 const first = Effect.fnUntraced(function* (fs, directory, files) {
 	for (const name of names) {
@@ -5809,9 +5883,9 @@ const shadowing = (location) => {
 	return location.space.location.startsWith(`${main}/`) ? main : void 0;
 };
 /** One file per directory from the sandbox root down to the cwd, closest last so it has the final word. */
-const discover = Effect.fnUntraced(function* (fs, location) {
+const discover$1 = Effect.fnUntraced(function* (fs, location) {
 	const chain = ancestors(location.directory);
-	const files = yield* present$1(fs, chain.flatMap((directory) => names.map((name) => posix.join(directory, name))));
+	const files = yield* present$1(fs, chain.flatMap((directory) => names.map((name) => posix.join(directory, name))), "file", "instruction file");
 	const found = yield* Effect.forEach(chain, (directory) => first(fs, directory, files), { concurrency: "unbounded" });
 	const main = shadowing(location);
 	const worktree = main === void 0 ? void 0 : found[chain.indexOf(location.space.location)];
@@ -5827,7 +5901,7 @@ const instructionPlugin = (0, plugin_exports$1.define)({
 	kind: "prompt",
 	setup: Effect.fn("InstructionPlugin.setup")(function* (ctx) {
 		const fs = yield* io_exports.SandboxIO.FileSystem;
-		const files = (yield* discover(fs, ctx.location)).filter((file) => file.content !== void 0);
+		const files = (yield* discover$1(fs, ctx.location)).filter((file) => file.content !== void 0);
 		if (files.length === 0) return;
 		const prompt = ctx.plugin.prompt;
 		prompt.sections.append(Section.ProjectContext, "Project-Specific Instructions & Guidelines:");
@@ -5835,6 +5909,236 @@ const instructionPlugin = (0, plugin_exports$1.define)({
 	})
 });
 //#endregion
+//#region src/plugin/builtin/prompt/skill.ts
+/** Max name length per Agent Skills spec. */
+const MAX_NAME_LENGTH = 64;
+/** Max description length per Agent Skills spec. */
+const MAX_DESCRIPTION_LENGTH = 1024;
+const IGNORE_FILE_NAMES = [
+	".gitignore",
+	".ignore",
+	".fdignore"
+];
+const normalizeNewlines = (value) => value.replaceAll("\r\n", "\n").replaceAll("\r", "\n");
+const extractFrontmatter = (content) => {
+	const normalized = normalizeNewlines(stripBom$1(content));
+	if (!normalized.startsWith("---")) return void 0;
+	const endIndex = normalized.indexOf("\n---", 3);
+	if (endIndex === -1) return void 0;
+	return normalized.slice(4, endIndex);
+};
+const parseFrontmatter = (raw) => {
+	const yamlString = extractFrontmatter(raw);
+	if (yamlString === void 0) return { frontmatter: {} };
+	try {
+		const parsed = parse$1(yamlString);
+		return { frontmatter: typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : {} };
+	} catch (error) {
+		return {
+			frontmatter: {},
+			error
+		};
+	}
+};
+const validateName = (name) => {
+	const errors = [];
+	if (name.length > MAX_NAME_LENGTH) errors.push(`name exceeds ${MAX_NAME_LENGTH} characters (${name.length})`);
+	if (!/^[a-z0-9-]+$/.test(name)) errors.push("name contains invalid characters (must be lowercase a-z, 0-9, hyphens only)");
+	if (name.startsWith("-") || name.endsWith("-")) errors.push("name must not start or end with a hyphen");
+	if (name.includes("--")) errors.push("name must not contain consecutive hyphens");
+	return errors;
+};
+const validateDescription = (description) => {
+	const errors = [];
+	if (typeof description !== "string" || description.trim() === "") errors.push("description is required");
+	else if (description.length > MAX_DESCRIPTION_LENGTH) errors.push(`description exceeds ${MAX_DESCRIPTION_LENGTH} characters (${description.length})`);
+	return errors;
+};
+const prefixIgnorePattern = (line, prefix) => {
+	const trimmed = line.trim();
+	if (!trimmed) return void 0;
+	if (trimmed.startsWith("#") && !trimmed.startsWith("\\#")) return void 0;
+	let pattern = line;
+	let negated = false;
+	if (pattern.startsWith("!")) {
+		negated = true;
+		pattern = pattern.slice(1);
+	} else if (pattern.startsWith("\\!")) pattern = pattern.slice(1);
+	if (pattern.startsWith("/")) pattern = pattern.slice(1);
+	const prefixed = prefix ? `${prefix}${pattern}` : pattern;
+	return negated ? `!${prefixed}` : prefixed;
+};
+const addIgnoreRules = Effect.fnUntraced(function* (fs, ig, dir, root, entryNames) {
+	const relativeDir = posix.relative(root, dir);
+	const prefix = relativeDir && relativeDir !== "." ? `${relativeDir}/` : "";
+	const presentIgnoreFiles = IGNORE_FILE_NAMES.filter((name) => entryNames.has(name));
+	if (presentIgnoreFiles.length === 0) return;
+	const contents = yield* Effect.forEach(presentIgnoreFiles, (filename) => fs.readFile(posix.join(dir, filename)).pipe(Effect.option), { concurrency: "unbounded" });
+	for (const content of contents) {
+		if (Option.isNone(content)) continue;
+		const patterns = content.value.split(/\r?\n/).map((line) => prefixIgnorePattern(line, prefix)).filter((line) => line !== void 0);
+		if (patterns.length > 0) ig.add(patterns);
+	}
+});
+const loadSkillFromFile = Effect.fnUntraced(function* (fs, filePath) {
+	const isDeclaredSkill = posix.basename(filePath) === "SKILL.md";
+	const raw = yield* fs.readFile(filePath).pipe(Effect.tapError((error) => Effect.logWarning(`could not read skill file ${filePath}`, error.cause)), Effect.option);
+	if (Option.isNone(raw)) return void 0;
+	const { frontmatter, error } = parseFrontmatter(raw.value);
+	if (error !== void 0) {
+		if (isDeclaredSkill) yield* Effect.logWarning(`could not parse skill file ${filePath}`, error);
+		return;
+	}
+	const description = frontmatter.description;
+	const hasDescription = typeof description === "string" && description.trim() !== "";
+	if (!isDeclaredSkill && !hasDescription) return void 0;
+	const skillDir = posix.dirname(filePath);
+	const parentDirName = posix.basename(skillDir);
+	for (const error of validateDescription(description)) yield* Effect.logWarning(`skill ${filePath}: ${error}`);
+	const name = (typeof frontmatter.name === "string" ? frontmatter.name : void 0) || parentDirName;
+	for (const error of validateName(name)) yield* Effect.logWarning(`skill ${filePath}: ${error}`);
+	if (!hasDescription) return void 0;
+	return {
+		name,
+		description,
+		filePath,
+		baseDir: skillDir,
+		disableModelInvocation: frontmatter["disable-model-invocation"] === true
+	};
+});
+const scanDir = (fs, dir, mode, root, ig, visited) => Effect.gen(function* () {
+	const realDir = yield* realpath(fs, dir);
+	if (visited.has(realDir)) return [];
+	const nextVisited = /* @__PURE__ */ new Set([...visited, realDir]);
+	const listed = yield* fs.readdir(dir).pipe(Effect.tapError((error) => filesystem_exports.SandboxFileSystem.isNotFoundError(error.cause) ? Effect.void : Effect.logWarning(`could not read skill directory ${dir}`, error.cause)), Effect.option);
+	if (Option.isNone(listed)) return [];
+	const entries = [...listed.value].sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
+	const entrySet = new Set(entries);
+	yield* addIgnoreRules(fs, ig, dir, root, entrySet);
+	if (entrySet.has("SKILL.md")) {
+		const fullPath = posix.join(dir, "SKILL.md");
+		const relPath = posix.relative(root, fullPath);
+		if ((yield* isFile(fs, fullPath)) && !ig.ignores(relPath)) {
+			const skill = yield* loadSkillFromFile(fs, fullPath);
+			return skill === void 0 ? [] : [skill];
+		}
+	}
+	const visible = entries.filter((name) => !name.startsWith(".") && name !== "node_modules");
+	const statted = yield* Effect.forEach(visible, (name) => {
+		const fullPath = posix.join(dir, name);
+		return fs.stat(fullPath).pipe(Effect.map((stat) => ({
+			name,
+			fullPath,
+			stat
+		})), Effect.option);
+	}, { concurrency: "unbounded" });
+	const skills = [];
+	for (const item of statted) {
+		if (Option.isNone(item)) continue;
+		const { name, fullPath, stat } = item.value;
+		const relPath = posix.relative(root, fullPath);
+		if (ig.ignores(stat.isDirectory ? `${relPath}/` : relPath)) continue;
+		if (stat.isDirectory) {
+			const nested = yield* scanDir(fs, fullPath, mode, root, ig, nextVisited);
+			skills.push(...nested);
+			continue;
+		}
+		if (stat.isFile && name.endsWith(".md") && (mode === "codework" && dir === root || mode === "agents" && dir !== root)) {
+			const skill = yield* loadSkillFromFile(fs, fullPath);
+			if (skill !== void 0) skills.push(skill);
+		}
+	}
+	return skills;
+});
+/**
+* Load skills from a single directory in the sandbox.
+*
+* Discovery rules:
+* - If a directory contains `SKILL.md`, treat it as a skill root and do not recurse further.
+* - In `"codework"` mode, direct `.md` children in the root are also loaded; in `"agents"` mode,
+*   `.md` files in subdirectories are loaded while root `.md` files are ignored.
+* - Recurse into subdirectories (skipping dotfiles, `node_modules`, and ignored paths).
+*/
+const loadSkillsFromDir = (fs, dir, mode) => scanDir(fs, dir, mode, dir, ignore(), /* @__PURE__ */ new Set());
+/**
+* Discover skills inside the sandbox: `.codework/skills` at the cwd, then
+* `.agents/skills` from the cwd up to the git root (the closest ancestor holding `.git`), or up to
+* the sandbox root outside a repository. Earlier skills win name collisions.
+*/
+const discover = Effect.fnUntraced(function* (fs, location) {
+	const chain = ancestors(location.directory);
+	const own = posix.join(location.directory, appConfigDir, "skills");
+	const agents = chain.map((directory) => posix.join(directory, ".agents", "skills"));
+	const [dirs, gits] = yield* Effect.all([present$1(fs, [own, ...agents], "directory", "skill directory"), present$1(fs, chain.map((directory) => posix.join(directory, ".git")), "entry", "git marker")], { concurrency: "unbounded" });
+	const root = chain.findIndex((directory) => gits.has(posix.join(directory, ".git")));
+	const walked = root === -1 ? agents : agents.slice(0, root + 1);
+	const sources = [{
+		dir: own,
+		mode: "codework"
+	}, ...walked.map((dir) => ({
+		dir,
+		mode: "agents"
+	}))].filter(({ dir }) => dirs.has(dir));
+	const found = yield* Effect.forEach(sources, ({ dir, mode }) => loadSkillsFromDir(fs, dir, mode), { concurrency: "unbounded" });
+	const skillMap = /* @__PURE__ */ new Map();
+	const realPathSet = /* @__PURE__ */ new Set();
+	for (const skill of found.flat()) {
+		const realPath = yield* realpath(fs, skill.filePath);
+		if (realPathSet.has(realPath)) continue;
+		const existing = skillMap.get(skill.name);
+		if (existing !== void 0) yield* Effect.logWarning(`skill ${skill.filePath}: name "${skill.name}" collision with ${existing.filePath}`);
+		else {
+			skillMap.set(skill.name, skill);
+			realPathSet.add(realPath);
+		}
+	}
+	return Array.from(skillMap.values());
+});
+const escapeXml = (str) => str.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
+/**
+* Format skills for inclusion in `Section.Skills` per the Agent Skills specification.
+* Skills with `disableModelInvocation: true` are excluded from the prompt.
+*/
+const formatSkillsForPrompt = (skills, fileReadTool = "read") => {
+	const visibleSkills = skills.filter((s) => !s.disableModelInvocation);
+	if (visibleSkills.length === 0) return "";
+	const lines = [
+		"The following skills provide specialized instructions for specific tasks.",
+		fileReadTool === "read" ? "Use the read tool to load a skill's file when the task matches its description." : fileReadTool === "bash" ? "Use bash to load a skill's file when the task matches its description." : "Load a skill's file when the task matches its description.",
+		"When a skill file references a relative path, resolve it against the skill directory (parent of SKILL.md / dirname of the path) and use that absolute path in tool commands.",
+		"",
+		"<available_skills>"
+	];
+	for (const skill of visibleSkills) {
+		lines.push("  <skill>");
+		lines.push(`    <name>${escapeXml(skill.name)}</name>`);
+		lines.push(`    <description>${escapeXml(skill.description)}</description>`);
+		lines.push(`    <location>${escapeXml(skill.filePath)}</location>`);
+		lines.push("  </skill>");
+	}
+	lines.push("</available_skills>");
+	return lines.join("\n");
+};
+const readers = ["read", "bash"];
+const skillPlugin = (0, plugin_exports$1.define)({
+	id: "codework.prompt.skill",
+	kind: "prompt",
+	setup: Effect.fn("SkillPlugin.setup")(function* (ctx) {
+		const tools = ctx.plugin.tools;
+		const visible = (name) => {
+			const tool = tools.get(name);
+			return tool !== void 0 && tool.promptSnippet !== void 0 && tool.promptSnippet.length > 0;
+		};
+		const fileReadTool = readers.find(visible) ?? (readers.some((name) => tools.has(name)) ? "indirect" : void 0);
+		if (fileReadTool === void 0) return;
+		const fs = yield* io_exports.SandboxIO.FileSystem;
+		const skills = yield* discover(fs, ctx.location);
+		const formatted = formatSkillsForPrompt(skills, fileReadTool);
+		if (formatted.length === 0) return;
+		ctx.plugin.prompt.sections.append(Section.Skills, formatted);
+	})
+});
+//#endregion
 //#region src/tool/truncate.ts
 /**
 * Shared truncation utilities for tool outputs.
@@ -6165,7 +6469,7 @@ const script = (command, file, limits, pipeline, report) => [
 	"run 2>&1"
 ].join("\n");
 const header = new RegExp(`^${HEADER} (\\d+) (\\d+) ([01])(?: (\\d+))?$`, "m");
-const parse$3 = (match) => ({
+const parse$4 = (match) => ({
 	bytes: Number(match[1]),
 	newlines: Number(match[2]),
 	kept: match[3] === "1"
@@ -6184,7 +6488,7 @@ const report = (stderr) => {
 		rest: stderr
 	};
 	return {
-		report: parse$3(match),
+		report: parse$4(match),
 		rest: stderr.slice(0, match.index) + stderr.slice(match.index + match[0].length).replace(/^\n/, "")
 	};
 };
@@ -6207,7 +6511,7 @@ const window = (stdout) => {
 	const match = header.exec(newline === -1 ? stdout : stdout.slice(0, newline));
 	if (match === null || match[4] === void 0) return void 0;
 	return {
-		...parse$3(match),
+		...parse$4(match),
 		text: stdout.slice(newline + 1),
 		textBytes: Number(match[4])
 	};
@@ -7282,7 +7586,7 @@ const pipeline = (argv, limit, errors) => [
 ].join("; ");
 const STATUS = /^\{"type":"rc","code":(\d+)\}$/;
 /** The pipeline's output: match events, ripgrep's status, and anything else, which is its stderr. */
-const parse$2 = (stdout, stderr) => {
+const parse$3 = (stdout, stderr) => {
 	const matches = [];
 	const errors = [];
 	let status;
@@ -7366,7 +7670,7 @@ const grepHandler = (params) => Effect.gen(function* () {
 		if (params.glob) argv.push("--glob", params.glob);
 		argv.push("-e", params.pattern, searchPath);
 		const result = yield* shell.exec(pipeline(argv, limit, errors));
-		const parsed = parse$2(result.stdout, result.stderr);
+		const parsed = parse$3(result.stdout, result.stderr);
 		return {
 			...parsed,
 			exitCode: parsed.status ?? result.exitCode
@@ -7931,7 +8235,8 @@ const builtins = Object.freeze([
 	findPlugin,
 	lsPlugin,
 	defaultPromptPlugin,
-	instructionPlugin
+	instructionPlugin,
+	skillPlugin
 ]);
 //#endregion
 //#region src/plugin/error.ts
@@ -8371,7 +8676,7 @@ const isPath = (reference) => reference.startsWith("file:") || reference.startsW
 * - a **CLI argument** anchors to the process's startup directory, because that is where the
 *   person typed it.
 */
-const parse$1 = (reference, from) => Effect.gen(function* () {
+const parse$2 = (reference, from) => Effect.gen(function* () {
 	const fail = (reason, message) => new SourceError({
 		reason,
 		reference,
@@ -9047,7 +9352,7 @@ const inspect = Effect.fn("PluginLoader.inspect")(function* (reference, options)
 		reference,
 		file: options.file
 	};
-	const target = yield* parse$1(reference, options.hostDir);
+	const target = yield* parse$2(reference, options.hostDir);
 	const loaded = yield* load$2(target, origin, options);
 	return {
 		id: loaded.plugin.id,
@@ -9073,7 +9378,7 @@ const load$2 = Effect.fn("PluginLoader.load")(function* (target, origin, options
 * are one package, and `./plugins/x.ts` is the file it resolves to from the directory that
 * declared it. Pure -- nothing is installed, imported or read.
 */
-const canonical = (reference, hostDir) => Effect.map(parse$1(reference, hostDir), canonical$1);
+const canonical = (reference, hostDir) => Effect.map(parse$2(reference, hostDir), canonical$1);
 //#endregion
 //#region src/plugin/catalog.ts
 /**
@@ -9135,7 +9440,7 @@ const load$1 = Effect.fn("PluginCatalog.load")(function* (references, options) {
 			remember(plugin, []);
 			continue;
 		}
-		const target = yield* parse$1(reference, options.hostDir);
+		const target = yield* parse$2(reference, options.hostDir);
 		const key = target.kind === "local" ? target.path : target.spec;
 		const already = seen.get(key);
 		if (already !== void 0) {
@@ -11318,7 +11623,7 @@ var harness_exports = /* @__PURE__ */ __exportAll({
 const layer = (options = {}) => Layer.unwrap(Effect.gen(function* () {
 	const hostCwd = options.hostCwd ?? process.cwd();
 	const paths = yield* resolve$4(options.home === void 0 ? {} : { home: hostPath.resolve(hostCwd, expandTilde(options.home, hostPath)) });
-	const global = layerWith(paths);
+	const global = layerWith$1(paths);
 	const settingsOptions = options.userConfigDir === void 0 ? {} : { userConfigDir: userConfigDir(options.userConfigDir, hostCwd) };
 	const config = yield* load$3({
 		...settingsOptions,
@@ -11337,7 +11642,7 @@ const layer = (options = {}) => Layer.unwrap(Effect.gen(function* () {
 	* `hostDir` led to; only the process view falls back to `hostCwd`.
 	*/
 	const hostDirOf = (root) => root ?? hostCwd;
-	const filed = (reference, from) => parse$1(reference, from).pipe(Effect.flatMap((target) => target.kind === "local" ? fileSystem.exists(target.path).pipe(Effect.map((there) => there ? Option.some({}) : Option.none())) : resolve$2(target, paths.cache, from).pipe(Effect.map((entry) => Option.fromUndefinedOr(entry)))), Effect.orElseSucceed(() => Option.none()));
+	const filed = (reference, from) => parse$2(reference, from).pipe(Effect.flatMap((target) => target.kind === "local" ? fileSystem.exists(target.path).pipe(Effect.map((there) => there ? Option.some({}) : Option.none())) : resolve$2(target, paths.cache, from).pipe(Effect.map((entry) => Option.fromUndefinedOr(entry)))), Effect.orElseSucceed(() => Option.none()));
 	const resolveOnly = {
 		...catalogOptions,
 		install: required
@@ -11579,13 +11884,24 @@ const makeHandle = Effect.fn("Session.makeHandle")(function* (id) {
 		const space = Option.getOrUndefined(yield* sessions.space(id));
 		const sandbox = space === void 0 || space.env === instance_exports.SandboxInstance.ID.local ? void 0 : Option.getOrUndefined(yield* sandboxes.get(space.env));
 		const hostDir = Option.getOrUndefined(row.hostDir);
+		const project = Option.getOrUndefined(yield* sessions.project(id));
+		const config = Option.getOrUndefined(row.config);
+		const model = config?.model;
+		const thinkingLevel = config?.thinkingLevel;
 		return {
 			id,
 			title: row.title,
 			directory: row.directory,
 			...hostDir === void 0 ? {} : { hostDir },
 			hasHostLink: hostDir !== void 0,
-			...sandbox === void 0 ? {} : { sandbox }
+			...sandbox === void 0 ? {} : { sandbox },
+			...project === void 0 ? {} : { project: {
+				id: project.id,
+				name: project.name
+			} },
+			updatedAt: DateTime.toEpochMillis(row.updatedAt),
+			...model === void 0 ? {} : { model },
+			...thinkingLevel === void 0 ? {} : { thinkingLevel }
 		};
 	}).pipe(Effect.withSpan("Session.info"));
 	return {
@@ -11613,7 +11929,7 @@ const create$1 = Effect.fn("Session.create")(function* (input = {}) {
 	const sandboxes = yield* Controller;
 	const id = ID$1.create();
 	const sandboxId = input.sandbox?.id ?? instance_exports.SandboxInstance.ID.local;
-	const location = yield* sandboxes.withMount(sandboxId, Effect.provide(Service$8.use(Effect.succeed), layerMounted()), input.directory === void 0 ? void 0 : { cwd: input.directory });
+	const location = yield* sandboxes.withMount(sandboxId, Effect.provide(Service$8.use(Effect.succeed), layerMounted(input.project === void 0 ? void 0 : { name: input.project.name })), input.directory === void 0 ? void 0 : { cwd: input.directory });
 	yield* sessions.create({
 		id,
 		spaceId: location.space.id,
@@ -11727,7 +12043,7 @@ var plugin_exports = /* @__PURE__ */ __exportAll({
 	inspect: () => inspect,
 	lendResolve: () => lendResolve,
 	localName: () => localName,
-	parse: () => parse$1,
+	parse: () => parse$2,
 	probe: () => probe,
 	resolve: () => resolve$2,
 	resolveCached: () => required,
@@ -11740,6 +12056,6 @@ var DateTimeUtcFromMillis = schema_exports$9.DateTimeUtcFromMillis;
 var EventSchema = schema_exports$7.EventSchema;
 var SandboxError = errors_exports.SandboxError;
 var optional = schema_exports$9.optional;
-export { control_exports as Control, db_exports as Database, DateTimeUtcFromMillis, event_exports as Event, list_exports as EventList, registry_exports as EventRegistry, EventSchema, global_exports as Global, harness_exports as Harness, location_exports as Location, catalog_exports as ModelCatalog, plugin_exports as Plugin, schema_exports as PromptSchema, run_exports as Runner, sandbox_exports as Sandbox, SandboxError, session_exports as Session, session_exports$1 as SessionStore, settings_exports as Settings, state_exports as State, tool_exports as Tool, optional };
+export { control_exports as Control, db_exports as Database, DateTimeUtcFromMillis, event_exports as Event, list_exports as EventList, registry_exports as EventRegistry, EventSchema, global_exports as Global, harness_exports as Harness, location_exports as Location, catalog_exports as ModelCatalog, plugin_exports as Plugin, project_exports as Project, schema_exports as PromptSchema, run_exports as Runner, sandbox_exports as Sandbox, SandboxError, session_exports as Session, session_exports$1 as SessionStore, settings_exports as Settings, state_exports as State, tool_exports as Tool, optional };
 
 //# sourceMappingURL=effect.mjs.map