@nyte-ai/core 0.0.24 → 0.0.25-beta.1

package/dist/chunks/{compose-fnncnk81.js → compose-dywbt4he.js}

@@ -13,19 +13,19 @@ import {
   readRefExpectation2,
   put2,
   attempt2
-} from "./compose-vn7b7fdj.js";
+} from "./compose-ydth4n0z.js";
 import {
   commit2
-} from "./compose-bbhk8vnr.js";
+} from "./compose-s4kyfjj6.js";
 import {
   withFold2
-} from "./compose-xhtgytrh.js";
+} from "./compose-122g5jvb.js";
 import {
   waitFor2
-} from "./compose-bz70g01d.js";
+} from "./compose-kf2k4hq5.js";
 import {
   stopRun2
-} from "./compose-w6zb11k1.js";
+} from "./compose-kgdmzx0n.js";
 
 // src/engine/receipts.ts
 import { asId, SdkError } from "@nyte-ai/schema";

package/dist/chunks/{compose-xvbyp65f.js → compose-gnfmty38.js}

@@ -23,44 +23,63 @@ import {
   toCommitObjectId2,
   readCommit2,
   sessionEvent2
-} from "./compose-vn7b7fdj.js";
+} from "./compose-ydth4n0z.js";
 import {
   commit2
-} from "./compose-bbhk8vnr.js";
+} from "./compose-s4kyfjj6.js";
 import {
   withFold2
-} from "./compose-xhtgytrh.js";
+} from "./compose-122g5jvb.js";
 import {
-  send2
-} from "./compose-t9fcqtby.js";
+  send2,
+  sendNow2,
+  reviseQueued2
+} from "./compose-sjfbxw65.js";
+import {
+  leaseHold2,
+  releaseHold2
+} from "./compose-vxme67gg.js";
 import {
   move2
-} from "./compose-matk94se.js";
+} from "./compose-zajq79k0.js";
 import {
   watchStore2
 } from "./compose-zfjxkavf.js";
 import {
   configure2
-} from "./compose-a40dnhy5.js";
+} from "./compose-vphbntyn.js";
+import {
+  advanceSeen2
+} from "./compose-ztyjpn84.js";
 import {
   watchHead2,
   viewHead2,
   historyHead2
-} from "./compose-hfsn6pnt.js";
+} from "./compose-chcqk093.js";
 import {
   extractUserText2
 } from "./compose-rxsqmcgq.js";
+import {
+  holdMessage2
+} from "./compose-pb3420v8.js";
 
 // src/api/head.ts
 import { isJsonObject, SdkError } from "@nyte-ai/schema";
 var PREVIEW = 80;
-function headHandle2(kernel, context, session, head, admit = send2) {
+function headHandle2(kernel, context, session, head, activation = false) {
   const { principal } = context;
   const watch = (options) => watchHead2(kernel, { session, head, principal, options });
+  const revise = (message, content, options) => reviseQueued2(kernel, { session, head, context, message, content, options }, activation);
   return {
     sessionId: session,
     name: head,
-    send: (content, options) => admit(kernel, { session, head, context, content, options }),
+    send: (content, options) => (activation ? sendNow2 : send2)(kernel, { session, head, context, content, options }),
+    revise,
+    hold: (message) => holdMessage2(message, {
+      hold: () => leaseHold2(kernel, session, head, message),
+      revise: (content, options) => revise(message, content, options),
+      release: () => releaseHold2(kernel, session, head, message)
+    }),
     async configure(patch) {
       const outcome = await configure2(kernel, session, head, patch);
       if (outcome.kind === "configured" && context !== CORE_CONTEXT2 && context.origin === null && context.authority.has("owner") && (patch.model !== undefined || patch.thinking !== undefined))
@@ -69,6 +88,7 @@ function headHandle2(kernel, context, session, head, admit = send2) {
     },
     view: (options) => viewHead2(kernel, { session, head, principal, options }),
     watch,
+    see: (tip) => advanceSeen2(kernel, { session, head, principal, commit: tip }),
     ...watchStore2(() => watch()),
     history: (input) => historyHead2(kernel, { session, head, principal, before: input.before, limit: input.limit }),
     tree: () => tree2(kernel, session, head),

package/dist/chunks/{compose-mdwr0er9.js → compose-h0d0vess.js}

@@ -3,14 +3,14 @@ import {
 } from "./compose-q6c7wswc.js";
 import {
   put2
-} from "./compose-vn7b7fdj.js";
+} from "./compose-ydth4n0z.js";
 import {
   convertJsonSchema2,
   check2
 } from "./compose-bj54tkph.js";
 import {
   commit2
-} from "./compose-bbhk8vnr.js";
+} from "./compose-s4kyfjj6.js";
 import {
   MODEL_PREFERENCE2,
   modelListingRef2,
@@ -19,13 +19,13 @@ import {
   readThinkingPreference2,
   readThinkingPreferences2,
   readModelSelection2
-} from "./compose-csh5vv2t.js";
+} from "./compose-6e9ktyhr.js";
 import {
   closable2
 } from "./compose-zfjxkavf.js";
 import {
   bumpGeneration2
-} from "./compose-ae5t6v5b.js";
+} from "./compose-zq7ar8qm.js";
 
 // src/extend/models.ts
 import { SdkError } from "@nyte-ai/schema";

package/dist/chunks/{compose-2gsbcjgv.js → compose-hf0nrd46.js}

@@ -4,7 +4,7 @@ import {
 import {
   decodeSessionRecord2,
   decodeSeenRecord2
-} from "./compose-gxjc6vz9.js";
+} from "./compose-dw8fvn94.js";
 import {
   objectId2
 } from "./compose-q6c7wswc.js";
@@ -27,7 +27,7 @@ import {
   attempt2,
   coversRecord2,
   sessionEvent2
-} from "./compose-vn7b7fdj.js";
+} from "./compose-ydth4n0z.js";
 import {
   traced2,
   followTrace2,
@@ -35,10 +35,10 @@ import {
 } from "./compose-sd0stm97.js";
 import {
   commit2
-} from "./compose-bbhk8vnr.js";
+} from "./compose-s4kyfjj6.js";
 import {
   stopRun2
-} from "./compose-w6zb11k1.js";
+} from "./compose-kgdmzx0n.js";
 import {
   refusalError2,
   staticContributions2
@@ -47,17 +47,16 @@ import {
   receiptHandle2,
   sendReceipt2,
   withdraw2
-} from "./compose-fnncnk81.js";
+} from "./compose-dywbt4he.js";
 import {
-  sendNow2,
   admitDeciding2
-} from "./compose-t9fcqtby.js";
+} from "./compose-sjfbxw65.js";
 import {
   recordAcquisition2
-} from "./compose-byse0eqj.js";
+} from "./compose-4s0c5zqv.js";
 import {
   runHandle2
-} from "./compose-qxfq6dn9.js";
+} from "./compose-d95420jw.js";
 import {
   latest2,
   closable2,
@@ -66,29 +65,29 @@ import {
 import {
   isolateWorkspace2,
   releaseWorktree2
-} from "./compose-ee0h1pk1.js";
+} from "./compose-3qkhfwtd.js";
 import {
   releaseStart2,
   stopStart2,
   discardSession2
-} from "./compose-nw5hdpxk.js";
+} from "./compose-ct1h40fd.js";
 import {
   runCommand2,
   completeSessionCommand2
-} from "./compose-ae5t6v5b.js";
+} from "./compose-zq7ar8qm.js";
 import {
   configure2
-} from "./compose-a40dnhy5.js";
+} from "./compose-vphbntyn.js";
 import {
   headHandle2,
   createHead2,
   mergeHead2,
   removeHead2
-} from "./compose-xvbyp65f.js";
+} from "./compose-gnfmty38.js";
 import {
   createPart2,
   partHandle2
-} from "./compose-r8tz1xfj.js";
+} from "./compose-zx78edb2.js";
 
 // src/api/session.ts
 import { asId, SdkError } from "@nyte-ai/schema";
@@ -154,7 +153,7 @@ function activated(kernel, part, session) {
 }
 function activationSession2(kernel, context, id) {
   const head = (name) => ({
-    ...headHandle2(kernel, context, id, name, sendNow2),
+    ...headHandle2(kernel, context, id, name, true),
     configure: (patch) => configure2(kernel, id, name, patch, true)
   });
   return {
@@ -300,7 +299,11 @@ async function start(kernel, context, input) {
     prompt: input.prompt ?? null,
     content: input.content
   };
-  const digest = await objectId2(input.isolation === undefined ? described : { ...described, isolation: input.isolation });
+  const digest = await objectId2({
+    ...described,
+    ...input.isolation === undefined ? {} : { isolation: input.isolation },
+    ...input.contextFiles === undefined ? {} : { contextFiles: input.contextFiles }
+  });
   const trace = (origin === null ? null : followedTrace2(origin.session)) ?? receipt;
   followTrace2(id, trace);
   return traced2("host.admit", trace, { session: id }, async () => {
@@ -338,7 +341,8 @@ async function start(kernel, context, input) {
         createdAt: at,
         lastActivityAt: at,
         heads: [{ name: MAIN2, stack: null, selected, lastRun: null }],
-        prompt: input.prompt ?? null
+        prompt: input.prompt ?? null,
+        ...input.contextFiles === undefined ? {} : { contextFiles: input.contextFiles }
       };
       const outcome = await commit2(kernel, [
         {

package/dist/chunks/{compose-mcz93154.js → compose-ht5fhzzw.js}

@@ -11,7 +11,7 @@ import {
 import {
   decodeRunRecord2,
   decodePartRecord2
-} from "./compose-gxjc6vz9.js";
+} from "./compose-dw8fvn94.js";
 import {
   dev2
 } from "./compose-n116fnmp.js";
@@ -29,36 +29,36 @@ import {
   attempt2,
   readCall2,
   readCalls2
-} from "./compose-vn7b7fdj.js";
+} from "./compose-ydth4n0z.js";
 import {
   readAttributedPaths2,
   ownedChanges2,
   anotherChatLive2
-} from "./compose-yfcb6w2h.js";
+} from "./compose-0zrwy7nk.js";
 import {
   settling2
-} from "./compose-d95fwwvw.js";
+} from "./compose-kwbs1f34.js";
 import {
   commit2
-} from "./compose-bbhk8vnr.js";
+} from "./compose-s4kyfjj6.js";
 import {
   signalsPark2,
   parkStep2,
   runStep2
-} from "./compose-byse0eqj.js";
+} from "./compose-4s0c5zqv.js";
 import {
   startJob2
-} from "./compose-nkxwrphm.js";
+} from "./compose-17xxey5y.js";
 import {
   publishPatch2
-} from "./compose-qxfq6dn9.js";
+} from "./compose-d95420jw.js";
 import {
   hiddenOwners2,
   missingCapabilities2
-} from "./compose-bd8c5n7k.js";
+} from "./compose-qyjchprv.js";
 import {
   toolSource2
-} from "./compose-ae5t6v5b.js";
+} from "./compose-zq7ar8qm.js";
 
 // src/agent/tool-runner.ts
 import { Type } from "typebox";

package/dist/chunks/{compose-8pp3vtv0.js → compose-hx8j2kef.js}

@@ -1,6 +1,6 @@
 import {
   decodeTrustRecord2
-} from "./compose-gxjc6vz9.js";
+} from "./compose-dw8fvn94.js";
 import {
   trustRef2,
   trustTarget2,
@@ -10,13 +10,13 @@ import {
   load2,
   put2,
   readKv2
-} from "./compose-vn7b7fdj.js";
+} from "./compose-ydth4n0z.js";
 import {
   commit2
-} from "./compose-bbhk8vnr.js";
+} from "./compose-s4kyfjj6.js";
 import {
   workspaceRecords2
-} from "./compose-4ppmas7g.js";
+} from "./compose-zt2qtrxj.js";
 
 // src/env/trust.ts
 import { Value } from "typebox/value";

package/dist/chunks/{compose-c4z4kp98.js → compose-j8xmyfy6.js}

@@ -7,21 +7,21 @@ import {
 import {
   requireSession2,
   readKv2
-} from "./compose-vn7b7fdj.js";
+} from "./compose-ydth4n0z.js";
 import {
   classifyFileSupport2,
   readWorkspace2
-} from "./compose-4ppmas7g.js";
+} from "./compose-zt2qtrxj.js";
 import {
   WORKSPACE_TRUST2,
   projectTrust2
-} from "./compose-8pp3vtv0.js";
+} from "./compose-hx8j2kef.js";
 
 // src/extend/resources.ts
 import { SdkError, standard } from "@nyte-ai/schema";
 import { Type } from "typebox";
 import { isMap, isScalar, parseDocument } from "yaml";
-var CONTEXT_NAMES = ["AGENTS.override.md", "AGENTS.md", "CLAUDE.md"];
+var CONTEXT_NAMES = ["AGENTS.override.md", "AGENTS.md", "AGENTS.MD", "CLAUDE.md", "CLAUDE.MD"];
 var SKILL_DIRECTORIES = [".nyte/skills", ".agents/skills"];
 var FRONTMATTER = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/;
 var ABSOLUTE = /^(?:\/|[A-Za-z]:[\\/])/;
@@ -29,7 +29,8 @@ var LINK_HOPS = 8;
 var SKILL_PATHS2 = "skills.paths";
 var scanIssues = new WeakMap;
 async function scanResources2(kernel, session) {
-  const workspace = (await requireSession2(kernel.store, session)).record.workspace;
+  const record = (await requireSession2(kernel.store, session)).record;
+  const workspace = record.workspace;
   const table = kernel.workspaceState.scans;
   const cached = table.get(session);
   if (cached !== undefined && cached.workspace === workspace)
@@ -38,7 +39,7 @@ async function scanResources2(kernel, session) {
   const watching = new AbortController;
   const entry = {
     workspace,
-    resources: scan(kernel, workspace, () => kernel.environments.attach(session)).then((resources) => {
+    resources: scan(kernel, workspace, () => kernel.environments.attach(session), record.contextFiles ?? true).then((resources) => {
       const api = kernel.plugins.runtimes().get(session)?.api("resources");
       for (const issue of resourceIssues2(resources))
         api?.report(issue);
@@ -77,7 +78,7 @@ function dropScans2(kernel, chosen = () => true) {
   }
 }
 function scanWorkspaceResources2(kernel, workspace) {
-  return scan(kernel, workspace, () => kernel.environments.attachWorkspace(workspace));
+  return scan(kernel, workspace, () => kernel.environments.attachWorkspace(workspace), true);
 }
 function resourceIssues2(resources) {
   return scanIssues.get(resources) ?? [];
@@ -161,11 +162,13 @@ function tryReadResources(api) {
     return null;
   }
 }
-async function scan(kernel, workspace, attach) {
+async function scan(kernel, workspace, attach, withContext) {
   const record = await readWorkspace2(kernel.store, workspace);
-  const user = await userFiles(kernel);
+  const homeEnv = await attachHome(kernel);
+  const user = homeEnv?.files ?? null;
   const trusted = record !== null && await projectTrust2(kernel, record) === true;
-  const attached = record !== null && classifyFileSupport2(kernel.environments.provider(record.target.kind)) === "available" ? attach() : null;
+  const provider = record === null ? undefined : kernel.environments.provider(record.target.kind);
+  const attached = classifyFileSupport2(provider) === "available" ? attach() : null;
   const env = attached === null ? null : trusted ? await attached : await attached.catch(() => null);
   const folder = env?.files ?? null;
   const project = trusted ? folder : null;
@@ -186,23 +189,11 @@ async function scan(kernel, workspace, attach) {
     message: `The ${item.scope} skill ${item.name} at ${item.location} is shadowed by the ${over.scope} one at ${over.location}.`,
     source: { plugin: "resources" }
   }));
-  const contextFiles = [];
-  if (user !== null && home !== null) {
-    const content = await readText(user, ".nyte/AGENTS.md");
-    if (content !== null)
-      contextFiles.push({ path: join(home, ".nyte/AGENTS.md"), scope: "user", content });
-  }
-  if (folder !== null && root !== null)
-    contextFiles.push(...await ancestorFiles(folder, root));
-  if (folder !== null) {
-    const found = await firstContext(folder, (name) => name);
-    if (found !== null)
-      contextFiles.push({
-        path: root === null ? found.path : join(root, found.path),
-        scope: "project",
-        content: found.content
-      });
-  }
+  const contextFiles = withContext ? await findContextFiles(homeEnv === null || home === null ? null : {
+    files: homeEnv.files,
+    real: realPaths(kernel.environments.provider("local"), homeEnv),
+    home
+  }, env === null ? null : { files: env.files, real: realPaths(provider, env), root }) : [];
   const [userSystem, userAppend, projectSystem, projectAppend] = await Promise.all([
     user === null ? null : readText(user, ".nyte/SYSTEM.md"),
     user === null ? null : readText(user, ".nyte/APPEND_SYSTEM.md"),
@@ -228,7 +219,7 @@ async function scan(kernel, workspace, attach) {
   scanIssues.set(resources, issues);
   return resources;
 }
-function userFiles(kernel) {
+function attachHome(kernel) {
   const state = kernel.workspaceState;
   if (state.home !== null)
     return state.home;
@@ -236,7 +227,7 @@ function userFiles(kernel) {
   const local = home === null ? undefined : kernel.environments.provider("local");
   if (home === null || local === undefined)
     return Promise.resolve(null);
-  const attached = local.attach({ kind: "local", path: home }).then((env) => env.files);
+  const attached = local.attach({ kind: "local", path: home });
   state.home = attached;
   attached.catch(() => {
     if (state.home === attached)
@@ -342,24 +333,100 @@ function parseSkillMetadata(content, fallback, location, scope) {
     description: fields.get("description") ?? ""
   };
 }
-async function ancestorFiles(files, root) {
+async function findContextFiles(user, folder) {
+  const root = folder?.root ?? null;
+  const [own, ancestors, project, shadowed] = await Promise.all([
+    user === null ? null : findContext(user, join(user.home, ".nyte"), "user"),
+    folder === null || root === null ? [] : ancestorContexts(folder, root),
+    folder === null ? null : findContext(folder, root, "project"),
+    folder === null || root === null ? null : findShadowedContext(folder, root).catch(() => null)
+  ]);
+  const seen = new Set;
+  return [own, ...ancestors, project].flatMap((found) => {
+    if (found === null || found.entry === shadowed || seen.has(found.real))
+      return [];
+    seen.add(found.real);
+    return [{ path: found.path, scope: found.scope, content: found.content }];
+  });
+}
+async function ancestorContexts(reader, root) {
   try {
-    const found = await Promise.all(listAncestorPaths(root).map(async (directory) => {
-      const context = await firstContext(files, (name) => join(directory, name));
-      return context === null ? [] : [{ ...context, scope: "ancestor" }];
-    }));
-    return found.flat();
+    const found = await Promise.all(listAncestorPaths(root).map((directory) => findContext(reader, directory, "ancestor")));
+    return found.filter((context) => context !== null);
   } catch {
     return [];
   }
 }
-async function firstContext(files, at) {
-  const read = await Promise.all(CONTEXT_NAMES.map(async (name) => {
-    const path = at(name);
-    const content = await readText(files, path);
-    return content === null ? null : { path, content };
-  }));
-  return read.find((context) => context !== null) ?? null;
+async function findContext(reader, directory, scope) {
+  const at = (name) => directory === null ? name : join(directory, name);
+  const read = await Promise.all(CONTEXT_NAMES.map(async (name) => ({ name, content: await readText(reader.files, at(name)) })));
+  const found = read.find((entry) => entry.content !== null);
+  if (found === undefined)
+    return null;
+  const path = at(found.name);
+  if (reader.real === null || directory === null)
+    return { path, scope, content: found.content, name: found.name, real: path, entry: path };
+  const [real, realDirectory, entry] = await Promise.all([
+    reader.real(path),
+    reader.real(directory),
+    reader.files.stat(path)
+  ]);
+  return {
+    path: real === null || entry?.kind === "symlink" ? path : join(directory, fileName(real)),
+    scope,
+    content: found.content,
+    name: found.name,
+    real: real ?? path,
+    entry: join(realDirectory ?? directory, found.name)
+  };
+}
+async function findShadowedContext(reader, root) {
+  const real = reader.real;
+  if (real === null)
+    return null;
+  const git = await findGitPaths(reader.files, root);
+  if (git === null)
+    return null;
+  const common = await real(git.common) ?? git.common;
+  const worktree = await real(git.repository) ?? git.repository;
+  const main = parentDirectory(common);
+  if (!worktree.startsWith(join(main, "")))
+    return null;
+  const mainGit = join(main, ".git");
+  if ((await real(mainGit) ?? mainGit) !== common)
+    return null;
+  const own = await findContext(reader, worktree, "ancestor");
+  return own === null ? null : join(main, own.name);
+}
+async function findGitPaths(files, root) {
+  for (const directory of [root, ...listAncestorPaths(root).toReversed()]) {
+    const dotGit = join(directory, ".git");
+    const found = await files.stat(dotGit);
+    if (found === null)
+      continue;
+    const text = found.kind === "directory" ? null : await readText(files, dotGit);
+    if (text === null) {
+      if (found.kind === "file")
+        continue;
+      return await files.stat(join(dotGit, "HEAD")) === null ? null : { repository: directory, common: dotGit };
+    }
+    const named = text.trim();
+    if (!named.startsWith("gitdir: "))
+      continue;
+    const gitDir = absolutePath(directory, named.slice("gitdir: ".length).trim());
+    if (await files.stat(join(gitDir, "HEAD")) === null)
+      return null;
+    const common = await readText(files, join(gitDir, "commondir"));
+    return {
+      repository: directory,
+      common: common === null ? gitDir : absolutePath(gitDir, common.trim())
+    };
+  }
+  return null;
+}
+function realPaths(provider, env) {
+  const realpath = provider?.realpath;
+  return realpath === undefined ? null : (path) => realpath(env, path);
 }
 async function listDirectChildren(files, directory, kinds) {
   const children = new Map;
@@ -432,5 +499,14 @@ function listAncestorPaths(root) {
 function join(directory, name) {
   return directory.endsWith("/") ? `${directory}${name}` : `${directory}/${name}`;
 }
+function absolutePath(base, path) {
+  return resolvePath(null, ABSOLUTE.test(path) ? path : join(base, path));
+}
+function parentDirectory(path) {
+  return path.slice(0, path.lastIndexOf("/")) || "/";
+}
+function fileName(path) {
+  return path.slice(path.lastIndexOf("/") + 1);
+}
 
 export { SKILL_PATHS2, scanResources2, dropScans2, scanWorkspaceResources2, resourceIssues2, resourcesPlugin2 };

package/dist/chunks/{compose-9jvn2wvh.js → compose-jawbhn7q.js}

@@ -15,6 +15,7 @@ var SHELL_BYTES = 32 * 1024;
 var PROGRESS_BYTES = 4 * 1024;
 var PROGRESS_MS = 80;
 var FIRST_OUTPUT_MS = 1000;
+var FOREGROUND_TIMEOUT_MS = 2 * 60 * 1000;
 var MIME_TYPES = new Map([
   ["png", "image/png"],
   ["jpg", "image/jpeg"],
@@ -45,13 +46,19 @@ var listParameters = standard(Type.Object({
   path: Type.Optional(Type.String({ description: "The directory to list; the workspace root by default." })),
   limit: Type.Optional(Type.Integer({ minimum: 1, description: "How many entries to list." }))
 }));
-var bashParameters = standard(Type.Object({
+var bashProperties2 = {
   command: Type.String({ description: "The shell command to run." }),
   description: Type.Optional(Type.String({ description: "What the command does, in a few words, for the user." })),
   background: Type.Optional(Type.Boolean({
     description: "Start the command and return a job id with its first output instead of waiting for it to exit. Use for servers, watchers, and other long-lived commands, without a trailing &. The command keeps running across turns, and you are told when it exits; read its output or stop it with the job tool. Do not use it to speed up ordinary commands."
+  })),
+  timeout: Type.Optional(Type.Integer({
+    minimum: 0,
+    maximum: 2147483647,
+    description: `Milliseconds before a foreground command is stopped; 0 for no limit. Default ${FOREGROUND_TIMEOUT_MS}. Background commands have no limit.`
   }))
-}));
+};
+var bashParameters = standard(Type.Object(bashProperties2));
 var jobParameters = standard(Type.Object({
   id: Type.String({ description: "The job id a background bash call returned." }),
   action: Type.Enum(["output", "stop"], {
@@ -197,12 +204,21 @@ var bash = {
       stop();
     const shell = createShellOutput((tail) => invocation.progress({ text: tail }));
     const frames = running.output()[Symbol.asyncIterator]();
+    const background = args.background === true;
+    const timeout = args.timeout ?? FOREGROUND_TIMEOUT_MS;
+    const waited = background ? FIRST_OUTPUT_MS : timeout;
     try {
-      const exited = await shell.read(frames, args.background === true ? AbortSignal.any([foreground.released, AbortSignal.timeout(FIRST_OUTPUT_MS)]) : foreground.released);
-      if (!exited && (foreground.released.aborted || foreground.release())) {
+      const exited = await shell.read(frames, waited === 0 ? foreground.released : AbortSignal.any([foreground.released, AbortSignal.timeout(waited)]));
+      if (!exited && (foreground.released.aborted || background && foreground.release())) {
         await frames.return?.();
         return text(shell.render(`[running in the background as job ${running.id}: you are told when it exits; the job tool reads its output or stops it]`));
       }
+      if (!exited && !background) {
+        stop();
+        await shell.read(frames, new AbortController().signal);
+        await running.settled();
+        return text(shell.render(`[stopped after ${timeout / 1000} s; pass a larger timeout if it needs longer]`));
+      }
       if (!exited)
         await shell.read(frames, new AbortController().signal);
       const end = await running.settled();
@@ -429,4 +445,4 @@ async function upload(files, path) {
   }
 }
 
-export { environmentPlugin2 };
+export { bashProperties2, environmentPlugin2 };

package/dist/chunks/{compose-2rha31fc.js → compose-jbrtw0md.js}

@@ -4,17 +4,17 @@ import {
 } from "./compose-q6c7wswc.js";
 import {
   readReceipt2
-} from "./compose-vn7b7fdj.js";
+} from "./compose-ydth4n0z.js";
 import {
   writeReceipt2
-} from "./compose-bbhk8vnr.js";
+} from "./compose-s4kyfjj6.js";
 import {
   waitFor2
-} from "./compose-bz70g01d.js";
+} from "./compose-kf2k4hq5.js";
 import {
   settleReceipt2,
   typedReceipt2
-} from "./compose-fnncnk81.js";
+} from "./compose-dywbt4he.js";
 
 // src/engine/batches.ts
 import { asId, SdkError } from "@nyte-ai/schema";

package/dist/chunks/{compose-m01wspwf.js → compose-jrxg4vqg.js}

@@ -3,7 +3,7 @@ import {
 } from "./compose-q6c7wswc.js";
 import {
   acquire2
-} from "./compose-nkxwrphm.js";
+} from "./compose-17xxey5y.js";
 
 // src/env/browser.ts
 import { asId, asSeq, SdkError } from "@nyte-ai/schema";