glove-foundry 0.5.0 → 0.5.2

package/README.md

@@ -71,13 +71,15 @@ If installation fails, your generated project remains available with retry steps
 
 ### Before deploying
 
-Persist **three separate things**: Foundry instance/activation data, Glove
-conversation history, and structured memory/VFS state. The demo's in-memory
-adapters intentionally reset and must not be mistaken for production persistence.
-Use `FileFoundryDataAdapter` for single-host runtime data, a durable conversation
-store, and `glove-memory/sqlite` or your own native memory adapters. Add VFS
-persistence when agents work on documents. Multi-host deployments need shared,
-transactional adapters. See [Building with Foundry](./docs/building-with-foundry.md).
+Every run executes in its own process, so nothing the next message needs can live
+only in memory. Persist **four separate things**: Foundry runtime data
+(instances, conversations, activations, workspace), Glove conversation
+transcripts, structured memory, and working-environment files. Persisting one does
+not persist the others. The starters keep all of them on disk under `.data/` with
+single-host adapters (`FileFoundryDataAdapter`, a file-backed transcript store in
+`lib/file-store.ts`, and — in the concierge — file-backed memory and VFS
+persistence). Multi-host deployments need shared, transactional adapters. See
+[Persistence](https://glove.dterminal.net/foundry/docs/persistence).
 
 **Troubleshooting:** check `node --version` for engine errors, add a provider key
 for the minimal starter, choose another `--port` if 4141 is occupied, and inspect a
@@ -317,21 +319,31 @@ projection is resolved only when the subagent is called, after instance
 installations and message-dependent assembly have completed.
 
 ```ts
+import { getToolJsonSchema } from "glove-core"
+
+// Names of tools the parent has mounted that the delegate may use.
+const READ_ONLY = new Set(["web_search", "web_read", "workspace_read_file"])
+
 defineSubagent({
   name: "researcher",
   description: "Research one bounded question",
   systemPrompt: "Return evidence, uncertainty, and a concise conclusion.",
-  tools: ({ parent }) => projectTools(parent, [
-    webSearchToolName,
-    webReadToolName,
-    "workspace_read_file",
-  ]),
+  tools: ({ parent }) =>
+    parent.tools
+      .filter((tool) => READ_ONLY.has(tool.name))
+      .map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        jsonSchema: getToolJsonSchema(tool),
+        do: (input, _display, _agent, signal) => tool.run(input, undefined, signal),
+      })),
 })
 ```
 
-The child keeps its isolated store, compaction policy, model, prompt, skills,
-layers, and subscribers. Parent subscribers still receive the subagent lifecycle
-bracket, so delegation remains visible in the same run trace.
+The child keeps its isolated store, compaction policy, model, prompt and skills.
+Its `layers` and `subscribers` mount when the subagent is invoked and are
+disposed when its request ends. Parent subscribers still receive the subagent
+lifecycle bracket, so delegation remains visible in the same run trace.
 
 ## Programmatic tool workflows
 

package/dist/{chunk-KBMD4RYU.js → chunk-6Q2LGPSC.js}

@@ -1,11 +1,14 @@
 import {
+  EMPTY_NATIVE_REGISTRY,
+  FOUNDRY_LAYER_BRAND,
+  FOUNDRY_SUBSCRIBER_BRAND,
   bindFileIdentity,
   defineAgentFromModule,
   fileDefinitionKey,
   fileDefinitionLabel,
   fileIdentified,
   internalAgentName
-} from "./chunk-5NFLGHOC.js";
+} from "./chunk-PVOKR4CN.js";
 
 // src/application.ts
 var FOUNDRY_APPLICATION_BRAND = /* @__PURE__ */ Symbol.for(
@@ -408,149 +411,6 @@ function isFoundryCapability(value) {
   return object[FOUNDRY_SHARED_TOOL_BRAND] === true || object[FOUNDRY_AGENT_APPLICATION_BRAND] === true || object[FOUNDRY_MCP_BRAND] === true || object[FOUNDRY_MEMORY_BRAND] === true;
 }
 
-// src/surfaces.ts
-import { Effect as Effect2 } from "effect";
-var FOUNDRY_LAYER_BRAND = /* @__PURE__ */ Symbol.for("glove-foundry-layer");
-var FOUNDRY_SUBSCRIBER_BRAND = /* @__PURE__ */ Symbol.for(
-  "glove-foundry-subscriber"
-);
-var SURFACE_ID = /^[a-z][a-z0-9-]*(?:\/[a-z][a-z0-9-]*)*$/;
-function assertSurfaceId(id2, label) {
-  if (!SURFACE_ID.test(id2)) {
-    throw new Error(
-      `Invalid Foundry ${label} id "${id2}". Use lowercase path segments containing letters, digits, and hyphens.`
-    );
-  }
-}
-function defineLayer(options) {
-  if (options.id) assertSurfaceId(options.id, "layer");
-  const { id: id2, ...definition } = options;
-  return Object.freeze(fileIdentified({
-    ...definition,
-    [FOUNDRY_LAYER_BRAND]: true
-  }, "layer", id2));
-}
-function configureLayer(layer, config) {
-  return Object.freeze({ layer, config });
-}
-function defineSubscriber(options) {
-  if (options.id) assertSurfaceId(options.id, "subscriber");
-  const { id: id2, ...definition } = options;
-  return Object.freeze(fileIdentified({
-    ...definition,
-    [FOUNDRY_SUBSCRIBER_BRAND]: true
-  }, "subscriber", id2));
-}
-var EMPTY_NATIVE_REGISTRY = Object.freeze({
-  layers: Object.freeze([]),
-  subscribers: Object.freeze([])
-});
-function indexById(values, label) {
-  const indexed = /* @__PURE__ */ new Map();
-  for (const value of values) {
-    if (indexed.has(value.id)) {
-      throw new Error(`Duplicate Foundry ${label} id "${value.id}".`);
-    }
-    indexed.set(value.id, value);
-  }
-  return indexed;
-}
-async function mountFoundrySurfaces(options) {
-  const layers = indexById(options.registry.layers, "layer");
-  const subscribers = indexById(options.registry.subscribers, "subscriber");
-  const cleanup = [];
-  const disposeAll = async () => {
-    const failures = [];
-    for (const dispose of cleanup.reverse()) {
-      try {
-        const result = dispose();
-        if (Effect2.isEffect(result)) await Effect2.runPromise(result);
-        else await Promise.resolve(result);
-      } catch (cause) {
-        failures.push(cause);
-      }
-    }
-    if (failures.length > 0) {
-      throw new AggregateError(failures, "Foundry surface cleanup failed.");
-    }
-  };
-  try {
-    for (const selected of options.subscribers ?? []) {
-      let definition = selected;
-      if (typeof definition === "object" && definition !== null && FOUNDRY_SUBSCRIBER_BRAND in definition) {
-        const registered = subscribers.get(definition.id);
-        if (!registered) {
-          throw new Error(
-            `Agent "${options.context.agentId}" references unknown subscriber "${definition.id}".`
-          );
-        }
-        definition = registered;
-      }
-      let subscriber;
-      let subscriberId = "inline";
-      if (typeof definition === "object" && definition !== null && definition[FOUNDRY_SUBSCRIBER_BRAND] === true) {
-        const foundrySubscriber = definition;
-        const created = typeof foundrySubscriber.create === "function" ? foundrySubscriber.create(options.context) : foundrySubscriber.create;
-        subscriber = Effect2.isEffect(created) ? await Effect2.runPromise(created) : await Promise.resolve(created);
-        subscriberId = foundrySubscriber.id;
-      } else {
-        subscriber = definition;
-      }
-      options.context.glove.addSubscriber(subscriber);
-      cleanup.push(() => options.context.glove.removeSubscriber(subscriber));
-      options.context.emit({
-        type: "foundry.subscriber.mounted",
-        data: { id: subscriberId }
-      });
-    }
-    for (const selected of options.layers ?? []) {
-      const reference = FOUNDRY_LAYER_BRAND in selected ? { layer: selected } : selected;
-      const definition = layers.get(reference.layer.id);
-      if (!definition) {
-        throw new Error(
-          `Agent "${options.context.agentId}" references unknown layer "${reference.layer.id}".`
-        );
-      }
-      const referenceConfig = "config" in reference ? reference.config : void 0;
-      const parsed = definition.config ? definition.config.safeParse(referenceConfig ?? {}) : { success: true, data: referenceConfig };
-      if (!parsed.success) {
-        throw new Error(
-          `Invalid config for layer "${definition.id}": ${parsed.error.message}`
-        );
-      }
-      const dispose = await Effect2.runPromise(
-        definition.setup({ ...options.context, config: parsed.data })
-      );
-      if (dispose) cleanup.push(dispose);
-      options.context.emit({
-        type: "foundry.layer.mounted",
-        data: { id: definition.id }
-      });
-    }
-  } catch (cause) {
-    try {
-      await disposeAll();
-    } catch (cleanupCause) {
-      throw new AggregateError(
-        [cause, cleanupCause],
-        "Foundry surface mount and cleanup failed."
-      );
-    }
-    throw cause;
-  }
-  return disposeAll;
-}
-function isFoundryLayer(value) {
-  return Boolean(
-    value && typeof value === "object" && value[FOUNDRY_LAYER_BRAND] === true
-  );
-}
-function isFoundrySubscriber(value) {
-  return Boolean(
-    value && typeof value === "object" && value[FOUNDRY_SUBSCRIBER_BRAND] === true
-  );
-}
-
 // src/composition.ts
 var composedToolBodies = /* @__PURE__ */ new WeakMap();
 function isToolBody(value) {
@@ -1274,7 +1134,7 @@ function createManifest(agents) {
 
 // src/primitives.ts
 import { randomUUID } from "node:crypto";
-import { Effect as Effect4 } from "effect";
+import { Effect as Effect3 } from "effect";
 function toGloveMessage(input) {
   if (typeof input === "string") {
     return freezeGloveMessage({ sender: "user", text: input });
@@ -1346,13 +1206,13 @@ var MemoryFoundryDataAdapter = class {
     this.pendingSubscriptions = [];
   }
   getAgent(id2) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       this.materializeSeeds();
       return this.agents.get(id2) ?? null;
     });
   }
   putAgent(agent) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       this.materializeSeeds();
       const reconstructed = reconstructAgentInstance(agent);
       const prior = this.agents.get(agent.id);
@@ -1366,13 +1226,13 @@ var MemoryFoundryDataAdapter = class {
     });
   }
   listAgents(definitionId) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       this.materializeSeeds();
       return [...this.agents.values()].filter((item) => !definitionId || item.definitionId === definitionId);
     });
   }
   provisionAgent(input) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       this.materializeSeeds();
       const existingId = this.agentsByProvisioningKey.get(input.provisioningKey);
       if (existingId) return this.agents.get(existingId);
@@ -1386,34 +1246,34 @@ var MemoryFoundryDataAdapter = class {
     });
   }
   getPlaybookSubscription(id2) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       this.materializeSeeds();
       return this.subscriptions.get(id2) ?? null;
     });
   }
   putPlaybookSubscription(subscription) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       this.materializeSeeds();
       this.subscriptions.set(subscription.id, reconstructPlaybookSubscription(subscription));
     });
   }
   deletePlaybookSubscription(id2) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       this.materializeSeeds();
       return this.subscriptions.delete(id2);
     });
   }
   listPlaybookSubscriptions(workspaceId) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       this.materializeSeeds();
       return [...this.subscriptions.values()].filter((item) => !workspaceId || item.workspaceId === workspaceId);
     });
   }
   getInboundDelivery(key) {
-    return Effect4.succeed(this.inboundDeliveries.get(key) ?? null);
+    return Effect3.succeed(this.inboundDeliveries.get(key) ?? null);
   }
   claimInboundDelivery(key) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       if (this.inboundDeliveries.has(key)) return false;
       this.inboundDeliveries.set(key, Object.freeze({
         key,
@@ -1425,7 +1285,7 @@ var MemoryFoundryDataAdapter = class {
     });
   }
   completeInboundDelivery(key, runIds) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       const prior = this.inboundDeliveries.get(key);
       if (!prior) throw new Error(`Inbound delivery claim "${key}" does not exist.`);
       this.inboundDeliveries.set(key, Object.freeze({
@@ -1437,46 +1297,46 @@ var MemoryFoundryDataAdapter = class {
     });
   }
   releaseInboundDelivery(key) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       if (this.inboundDeliveries.get(key)?.status === "pending") {
         this.inboundDeliveries.delete(key);
       }
     });
   }
   getActivation(id2) {
-    return Effect4.succeed(this.activations.get(id2) ?? null);
+    return Effect3.succeed(this.activations.get(id2) ?? null);
   }
   putActivation(activation) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       this.activations.set(activation.id, reconstructActivation(activation));
     });
   }
   listActivations(workspaceId) {
-    return Effect4.succeed(
+    return Effect3.succeed(
       [...this.activations.values()].filter((item) => !workspaceId || item.workspaceId === workspaceId)
     );
   }
   getConversation(id2) {
-    return Effect4.succeed(this.conversations.get(id2) ?? null);
+    return Effect3.succeed(this.conversations.get(id2) ?? null);
   }
   putConversation(conversation) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       this.conversations.set(conversation.id, Object.freeze({ ...conversation }));
     });
   }
   listConversations(agentId) {
-    return Effect4.succeed([...this.conversations.values()].filter((item) => item.agentId === agentId));
+    return Effect3.succeed([...this.conversations.values()].filter((item) => item.agentId === agentId));
   }
   getWorkspaceEntry(workspaceId, key) {
-    return Effect4.succeed(this.workspace.get(`${workspaceId}:${key}`) ?? null);
+    return Effect3.succeed(this.workspace.get(`${workspaceId}:${key}`) ?? null);
   }
   putWorkspaceEntry(entry) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       this.workspace.set(`${entry.workspaceId}:${entry.key}`, Object.freeze({ ...entry }));
     });
   }
   compareAndSetWorkspaceEntry(entry, expectedUpdatedAt) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       const key = `${entry.workspaceId}:${entry.key}`;
       const current = this.workspace.get(key);
       if ((current?.updatedAt ?? null) !== expectedUpdatedAt) return false;
@@ -1488,16 +1348,16 @@ var MemoryFoundryDataAdapter = class {
     });
   }
   listWorkspaceEntries(workspaceId) {
-    return Effect4.succeed([...this.workspace.values()].filter((item) => item.workspaceId === workspaceId));
+    return Effect3.succeed([...this.workspace.values()].filter((item) => item.workspaceId === workspaceId));
   }
   getWorkingEnvironmentSnapshot(owner) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       const snapshot = this.workingEnvironments.get(workingEnvironmentOwnerKey(owner));
       return snapshot ? structuredClone(snapshot) : null;
     });
   }
   putWorkingEnvironmentSnapshot(owner, snapshot) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       this.workingEnvironments.set(
         workingEnvironmentOwnerKey(owner),
         structuredClone(snapshot)
@@ -1505,23 +1365,23 @@ var MemoryFoundryDataAdapter = class {
     });
   }
   putInboxItem(item) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       this.inbox.set(item.id, Object.freeze({ ...item }));
     });
   }
   listInboxItems(workspaceId) {
-    return Effect4.succeed([...this.inbox.values()].filter((item) => item.workspaceId === workspaceId));
+    return Effect3.succeed([...this.inbox.values()].filter((item) => item.workspaceId === workspaceId));
   }
   putTask(task) {
-    return Effect4.sync(() => {
+    return Effect3.sync(() => {
       this.tasks.set(task.id, Object.freeze({ ...task }));
     });
   }
   listTasks(workspaceId) {
-    return Effect4.succeed([...this.tasks.values()].filter((item) => item.workspaceId === workspaceId));
+    return Effect3.succeed([...this.tasks.values()].filter((item) => item.workspaceId === workspaceId));
   }
   listEnvironment(scope) {
-    return Effect4.succeed(this.environment.filter(
+    return Effect3.succeed(this.environment.filter(
       (item) => item.workspaceId === scope.workspaceId && (item.scope === "workspace" || item.scope === "agent" && item.agentId === scope.agentId || item.scope === "conversation" && item.conversationId === scope.conversationId)
     ));
   }
@@ -1676,7 +1536,7 @@ function agentScheduleRevision(schedule) {
 
 // src/core-tools.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { Effect as Effect5, JSONSchema as JSONSchema2, Schema as Schema2 } from "effect";
+import { Effect as Effect4, JSONSchema as JSONSchema2, Schema as Schema2 } from "effect";
 import { z } from "zod";
 
 // src/core-command-result.ts
@@ -2036,7 +1896,7 @@ function createFoundryCoreTools(context, desiredSchedules = []) {
   };
   const scheduleView = async () => {
     const records = new Map(
-      [...context.activations, ...await Effect5.runPromise(context.data.listActivations(context.workspaceId))].filter((item) => item.kind === "scheduled" && item.agentId === context.agentId).map((item) => [item.id, item])
+      [...context.activations, ...await Effect4.runPromise(context.data.listActivations(context.workspaceId))].filter((item) => item.kind === "scheduled" && item.agentId === context.agentId).map((item) => [item.id, item])
     );
     const now = (/* @__PURE__ */ new Date()).toISOString();
     for (const desired of desiredSchedules) {
@@ -2354,7 +2214,7 @@ function createFoundryCoreTools(context, desiredSchedules = []) {
       description: "List the conversations owned by this runtime agent instance.",
       inputSchema: z.object({}),
       async do() {
-        return { status: "success", data: await Effect5.runPromise(context.data.listConversations(context.agentId)) };
+        return { status: "success", data: await Effect4.runPromise(context.data.listConversations(context.agentId)) };
       }
     },
     {
@@ -2367,12 +2227,12 @@ function createFoundryCoreTools(context, desiredSchedules = []) {
       ]),
       async do(input) {
         if (input.action === "get") {
-          return { status: "success", data: await Effect5.runPromise(context.data.getWorkspaceEntry(context.workspaceId, input.key)) };
+          return { status: "success", data: await Effect4.runPromise(context.data.getWorkspaceEntry(context.workspaceId, input.key)) };
         }
         if (input.action === "list") {
-          return { status: "success", data: await Effect5.runPromise(context.data.listWorkspaceEntries(context.workspaceId)) };
+          return { status: "success", data: await Effect4.runPromise(context.data.listWorkspaceEntries(context.workspaceId)) };
         }
-        await Effect5.runPromise(context.data.putWorkspaceEntry({
+        await Effect4.runPromise(context.data.putWorkspaceEntry({
           workspaceId: context.workspaceId,
           key: input.key,
           value: input.value,
@@ -2401,13 +2261,13 @@ function createFoundryCoreTools(context, desiredSchedules = []) {
       ]),
       async do(input) {
         if (input.action === "list") {
-          return { status: "success", data: await Effect5.runPromise(context.data.listInboxItems(context.workspaceId)) };
+          return { status: "success", data: await Effect4.runPromise(context.data.listInboxItems(context.workspaceId)) };
         }
         if (input.action === "update") {
-          const current = (await Effect5.runPromise(context.data.listInboxItems(context.workspaceId))).find((item3) => item3.id === input.itemId);
+          const current = (await Effect4.runPromise(context.data.listInboxItems(context.workspaceId))).find((item3) => item3.id === input.itemId);
           if (!current) return { status: "error", data: null, error: `Shared inbox item "${input.itemId}" was not found.` };
           const item2 = { ...current, status: input.status, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
-          await Effect5.runPromise(context.data.putInboxItem(item2));
+          await Effect4.runPromise(context.data.putInboxItem(item2));
           return { status: "success", data: item2 };
         }
         const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -2422,7 +2282,7 @@ function createFoundryCoreTools(context, desiredSchedules = []) {
           createdAt: now,
           updatedAt: now
         };
-        await Effect5.runPromise(context.data.putInboxItem(item));
+        await Effect4.runPromise(context.data.putInboxItem(item));
         return { status: "success", data: item };
       }
     },
@@ -2440,13 +2300,13 @@ function createFoundryCoreTools(context, desiredSchedules = []) {
       ]),
       async do(input) {
         if (input.action === "list") {
-          return { status: "success", data: await Effect5.runPromise(context.data.listTasks(context.workspaceId)) };
+          return { status: "success", data: await Effect4.runPromise(context.data.listTasks(context.workspaceId)) };
         }
         if (input.action === "update") {
-          const current = (await Effect5.runPromise(context.data.listTasks(context.workspaceId))).find((task3) => task3.id === input.taskId);
+          const current = (await Effect4.runPromise(context.data.listTasks(context.workspaceId))).find((task3) => task3.id === input.taskId);
           if (!current) return { status: "error", data: null, error: `Task "${input.taskId}" was not found.` };
           const task2 = { ...current, status: input.status, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
-          await Effect5.runPromise(context.data.putTask(task2));
+          await Effect4.runPromise(context.data.putTask(task2));
           return { status: "success", data: task2 };
         }
         const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -2461,7 +2321,7 @@ function createFoundryCoreTools(context, desiredSchedules = []) {
           createdAt: now,
           updatedAt: now
         };
-        await Effect5.runPromise(context.data.putTask(task));
+        await Effect4.runPromise(context.data.putTask(task));
         return { status: "success", data: task };
       }
     },
@@ -2472,7 +2332,7 @@ function createFoundryCoreTools(context, desiredSchedules = []) {
       async do() {
         return {
           status: "success",
-          data: await Effect5.runPromise(context.data.listEnvironment({
+          data: await Effect4.runPromise(context.data.listEnvironment({
             workspaceId: context.workspaceId,
             agentId: context.agentId,
             conversationId: context.conversationId
@@ -2716,15 +2576,6 @@ export {
   mountAgentDefinitionMemory,
   installRegistry,
   isFoundryCapability,
-  FOUNDRY_LAYER_BRAND,
-  FOUNDRY_SUBSCRIBER_BRAND,
-  defineLayer,
-  configureLayer,
-  defineSubscriber,
-  EMPTY_NATIVE_REGISTRY,
-  mountFoundrySurfaces,
-  isFoundryLayer,
-  isFoundrySubscriber,
   composeAgent,
   EMPTY_AGENT_COMPOSITION,
   FOUNDRY_CONNECTION_BRAND,

package/dist/{chunk-GKZLWD5M.js → chunk-7F7QVO6I.js}

@@ -81,8 +81,11 @@ var FoundryClient = class {
       return fetcher(input, { ...init, headers });
     } : fetcher;
   }
+  /** Resolves with `ok: false` when a subsystem is down (the server answers 503). */
   async health() {
-    return readResponse(await this.fetcher(`${this.baseUrl}/health`));
+    const response = await this.fetcher(`${this.baseUrl}/health`);
+    if (response.status === 503) return await response.json();
+    return readResponse(response);
   }
   agent(route) {
     return {