@agentshouse/kit 0.1.0-alpha.3 → 0.1.0-alpha.31

package/src/configuration.js

@@ -7,18 +7,10 @@ import {
   MIGRATOR_TIMEOUT_MS,
 } from "./contract.js";
 import { declarationReader } from "./declaration.js";
-import { GOOGLE_DRIVE_ID } from "./google/id.js";
 import { KitRefusal } from "./refusal.js";
 
-const PRESETS = new Set(["custom", "google"]);
 const AGENT_CLIENTS = new Set(["claude-code"]);
-const GOOGLE_CURATED_SERVICES = new Set(["gmail", "calendar", "drive"]);
 const ENVIRONMENT_VALUE_MAX = 4096;
-const GOOGLE_API_HOST = /^[a-z0-9-]+(?:\.[a-z0-9-]+)*\.googleapis\.com$/;
-const GOOGLE_API_PATH = /^\/[A-Za-z0-9._~!$&'()*+,;=:@%/-]+$/;
-const GOOGLE_API_SCOPE = /^https:\/\/www\.googleapis\.com\/auth\/[A-Za-z0-9._-]+$/;
-const EXTRACTION_PATH = /^(?:[A-Za-z_][A-Za-z0-9_-]*|\d+)(?:\.(?:[A-Za-z_][A-Za-z0-9_-]*|\d+))*$/;
-const QUERY_NAME = /^[A-Za-z][A-Za-z0-9_.-]{0,127}$/;
 
 const { refuse, plain, closed, text, positiveCount, filled } = declarationReader(
   "kit_configuration_invalid",
@@ -116,225 +108,33 @@ function backfillOf(value, declaration) {
   return { kind: named[0], bound: positiveCount(backfill[named[0]], declaration) };
 }
 
-function textList(value, declaration) {
-  return filled(value, declaration).map((entry, position) =>
-    text(entry, `${declaration}[${position}]`, 512),
-  );
-}
-
-function textArray(value, declaration) {
-  if (!Array.isArray(value)) refuse(declaration);
-  return value.map((entry, position) => text(entry, `${declaration}[${position}]`, 512));
-}
-
-function googleSelectionOf(value, declaration, service) {
-  if (service === "gmail") {
-    const selection = closed(value, ["labels"], declaration);
-    return { labels: textList(selection.labels, `${declaration}.labels`) };
-  }
-  if (service === "calendar") {
-    const selection = closed(value, ["calendars"], declaration);
-    return { calendars: textList(selection.calendars, `${declaration}.calendars`) };
-  }
-  if (service === "drive") {
-    const selection = closed(value, ["files", "folders"], declaration);
-    const files =
-      selection.files === undefined ? [] : textArray(selection.files, `${declaration}.files`);
-    const folders =
-      selection.folders === undefined ? [] : textArray(selection.folders, `${declaration}.folders`);
-    if (files.length + folders.length === 0) refuse(declaration);
-    files.forEach((id, position) => {
-      if (!GOOGLE_DRIVE_ID.test(id)) refuse(`${declaration}.files[${position}]`);
-    });
-    folders.forEach((id, position) => {
-      if (!GOOGLE_DRIVE_ID.test(id)) refuse(`${declaration}.folders[${position}]`);
-    });
-    return { files, folders };
-  }
-  refuse(declaration);
-}
-
-function extractionPath(value, declaration) {
-  const path = text(value, declaration, 512);
-  if (!EXTRACTION_PATH.test(path)) refuse(declaration);
-  return path;
-}
-
-function queryOf(value, declaration) {
-  const query = plain(value, declaration);
-  const parsed = {};
-  for (const [name, entry] of Object.entries(query)) {
-    if (!QUERY_NAME.test(name) || typeof entry !== "string" || entry.length > 2048) {
-      refuse(`${declaration}.${name}`);
-    }
-    parsed[name] = entry;
-  }
-  return parsed;
-}
-
-function declaredServiceOf(value, declaration) {
-  const declared = closed(
-    value,
-    ["host", "path", "query", "page_size", "page_token", "items", "fields", "scopes"],
-    declaration,
-  );
-  const host = text(declared.host, `${declaration}.host`, 253);
-  if (!GOOGLE_API_HOST.test(host)) refuse(`${declaration}.host`);
-  const path = text(declared.path, `${declaration}.path`, 2048);
-  if (!GOOGLE_API_PATH.test(path) || path.includes("..") || path.includes("//")) {
-    refuse(`${declaration}.path`);
-  }
-  const tokens = closed(
-    declared.page_token,
-    ["request", "response", "checkpoint_request", "checkpoint_response"],
-    `${declaration}.page_token`,
-  );
-  const pageToken = {
-    request: text(tokens.request, `${declaration}.page_token.request`, 128),
-    response: extractionPath(tokens.response, `${declaration}.page_token.response`),
-    checkpointRequest: text(
-      tokens.checkpoint_request,
-      `${declaration}.page_token.checkpoint_request`,
-      128,
-    ),
-    checkpointResponse: extractionPath(
-      tokens.checkpoint_response,
-      `${declaration}.page_token.checkpoint_response`,
-    ),
-  };
-  if (
-    !QUERY_NAME.test(pageToken.request) ||
-    !QUERY_NAME.test(pageToken.checkpointRequest) ||
-    pageToken.request === pageToken.checkpointRequest
-  ) {
-    refuse(`${declaration}.page_token`);
-  }
-  const fields = closed(
-    declared.fields,
-    [
-      "native_id",
-      "native_version",
-      "provider_modified_at",
-      "observed_at",
-      "body",
-      "container",
-      "author",
-      "url",
-    ],
-    `${declaration}.fields`,
-  );
-  const pageSize = text(declared.page_size, `${declaration}.page_size`, 128);
-  if (!QUERY_NAME.test(pageSize)) refuse(`${declaration}.page_size`);
-  const scopes = textList(declared.scopes, `${declaration}.scopes`).map((scope, position) => {
-    if (!GOOGLE_API_SCOPE.test(scope)) refuse(`${declaration}.scopes[${position}]`);
-    return scope;
-  });
-  return {
-    host,
-    path,
-    query: queryOf(declared.query, `${declaration}.query`),
-    pageSize,
-    scopes: [...new Set(scopes)],
-    pageToken,
-    items: extractionPath(declared.items, `${declaration}.items`),
-    fields: {
-      nativeId: extractionPath(fields.native_id, `${declaration}.fields.native_id`),
-      nativeVersion:
-        fields.native_version === undefined
-          ? null
-          : extractionPath(fields.native_version, `${declaration}.fields.native_version`),
-      providerModifiedAt:
-        fields.provider_modified_at === undefined
-          ? null
-          : extractionPath(
-              fields.provider_modified_at,
-              `${declaration}.fields.provider_modified_at`,
-            ),
-      observedAt: extractionPath(fields.observed_at, `${declaration}.fields.observed_at`),
-      body: textList(fields.body, `${declaration}.fields.body`).map((path, position) =>
-        extractionPath(path, `${declaration}.fields.body[${position}]`),
-      ),
-      container: extractionPath(fields.container, `${declaration}.fields.container`),
-      author:
-        fields.author === undefined
-          ? null
-          : extractionPath(fields.author, `${declaration}.fields.author`),
-      url:
-        fields.url === undefined ? null : extractionPath(fields.url, `${declaration}.fields.url`),
-    },
-  };
-}
-
-function serviceOf(value, declaration, preset) {
+function serviceOf(value, declaration) {
   const service = closed(
     value,
-    ["service", "source_ref", "rooms", "backfill", "connector", "selection", "declaration"],
+    ["service", "source_ref", "rooms", "backfill", "connector"],
     declaration,
   );
-  const name = declaredId(service.service, `${declaration}.service`);
-  if (preset === "custom" && service.connector === undefined) refuse(`${declaration}.connector`);
-  if (preset === "custom" && service.selection !== undefined) refuse(`${declaration}.selection`);
-  if (preset === "custom" && service.declaration !== undefined) refuse(`${declaration}.declaration`);
-  if (preset === "google" && service.connector !== undefined) refuse(`${declaration}.connector`);
-  if (preset === "google" && GOOGLE_CURATED_SERVICES.has(name) && service.declaration !== undefined) {
-    refuse(`${declaration}.declaration`);
-  }
-  if (preset === "google" && !GOOGLE_CURATED_SERVICES.has(name)) {
-    if (service.selection !== undefined) refuse(`${declaration}.selection`);
-    if (service.declaration === undefined) refuse(`${declaration}.declaration`);
-  }
   return {
-    service: name,
+    service: declaredId(service.service, `${declaration}.service`),
     sourceRef: text(service.source_ref, `${declaration}.source_ref`, 512),
     rooms: filled(service.rooms, `${declaration}.rooms`).map((room, position) =>
       text(room, `${declaration}.rooms[${position}]`, 512),
     ),
     backfill: backfillOf(service.backfill, `${declaration}.backfill`),
-    selection:
-      preset === "google" && GOOGLE_CURATED_SERVICES.has(name)
-        ? googleSelectionOf(service.selection, `${declaration}.selection`, name)
-        : null,
-    connector: preset === "custom" ? connectorOf(service.connector, `${declaration}.connector`) : null,
-    declaration:
-      preset === "google" && !GOOGLE_CURATED_SERVICES.has(name)
-        ? declaredServiceOf(service.declaration, `${declaration}.declaration`)
-        : null,
+    connector: connectorOf(service.connector, `${declaration}.connector`),
   };
 }
 
 function instanceOf(value, declaration) {
-  const instance = closed(value, ["id", "preset", "services", "scopes"], declaration);
-  const preset = declaredId(instance.preset, `${declaration}.preset`);
-  if (!PRESETS.has(preset)) refuse(`${declaration}.preset`);
-  if (preset !== "google" && instance.scopes !== undefined) refuse(`${declaration}.scopes`);
-  const scopes =
-    instance.scopes === undefined
-      ? []
-      : textList(instance.scopes, `${declaration}.scopes`).map((scope, position) => {
-          if (!GOOGLE_API_SCOPE.test(scope)) refuse(`${declaration}.scopes[${position}]`);
-          return scope;
-        });
+  const instance = closed(value, ["id", "preset", "services"], declaration);
   const services = filled(instance.services, `${declaration}.services`).map((service, position) =>
-    serviceOf(service, `${declaration}.services[${position}]`, preset),
+    serviceOf(service, `${declaration}.services[${position}]`),
   );
   services.forEach((service, position) => {
     const first = services.findIndex((candidate) => candidate.service === service.service);
     if (first !== position) refuse(`${declaration}.services[${position}].service`);
   });
-  services.forEach((service, position) => {
-    if (
-      service.declaration !== null &&
-      service.declaration.scopes.some((scope) => !scopes.includes(scope))
-    ) {
-      refuse(`${declaration}.services[${position}].declaration.scopes`);
-    }
-  });
-  return {
-    id: declaredId(instance.id, `${declaration}.id`),
-    preset,
-    services,
-    ...(preset === "google" ? { scopes: [...new Set(scopes)] } : {}),
-  };
+  return { id: declaredId(instance.id, `${declaration}.id`), preset: instance.preset, services };
 }
 
 function absolutePath(value, declaration) {
@@ -388,6 +188,7 @@ export function parseConfiguration(document) {
       "migrators",
       "clients",
       "host",
+      "skills",
     ],
     "configuration",
   );
@@ -397,10 +198,12 @@ export function parseConfiguration(document) {
   if (!EXECUTION_AUTHORITIES.includes(declared.execution_authority)) {
     refuse("execution_authority");
   }
+  const skills = declared.skills === undefined ? true : declared.skills;
+  if (typeof skills !== "boolean") refuse("skills");
   if (!Array.isArray(declared.instances)) refuse("instances");
   if (!Array.isArray(declared.migrators)) refuse("migrators");
-  const instances = declared.instances.map((instance, position) =>
-    instanceOf(instance, `instances[${position}]`),
+  const instances = declared.instances.flatMap((instance, position) =>
+    instance?.preset === "custom" ? [instanceOf(instance, `instances[${position}]`)] : [],
   );
   instances.forEach((instance, position) => {
     const first = instances.findIndex((candidate) => candidate.id === instance.id);
@@ -428,6 +231,7 @@ export function parseConfiguration(document) {
     migrators,
     clients,
     host: hostOf(declared.host, "host"),
+    skills,
   };
 }
 

package/src/connector-login.js

@@ -1,91 +1,10 @@
 import { readConfiguration, sourceInstance } from "./configuration.js";
 import { authorizeCustom, customAuthorizationStatus } from "./custom/authorization.js";
-import { googleAuthorization, authorizeGoogle, GOOGLE_SCOPES } from "./google/oauth.js";
-import { KitRefusal } from "./refusal.js";
 
-function googleServiceScopes(service) {
-  const curated = GOOGLE_SCOPES[service.service];
-  return curated === undefined ? service.declaration.scopes : [curated];
-}
-
-function googleServiceAuthorized(authorization, scopes) {
-  return authorization.grants.some((grant) =>
-    scopes.every((scope) => grant.scopes.includes(scope)),
-  );
-}
-
-function googleConsent(service, context) {
-  return async ({ url }) => {
-    const collected = await context.present(
-      {
-        steps: [
-          { kind: "visit", label: `Sign in to Google and allow access for ${service.service}`, url },
-          {
-            kind: "collect",
-            label: "The address your browser ended on",
-            name: "address",
-            description:
-              "After you allow access, Google sends your browser to a 127.0.0.1 address that does not open. Copy that whole address from the address bar and paste it here.",
-          },
-        ],
-      },
-      context.signal,
-    );
-    return collected.address;
-  };
-}
-
-const CONNECTOR_LOGINS = {
-  custom: {
-    status: customAuthorizationStatus,
-    login: authorizeCustom,
-  },
-  google: {
-    status: async (instance, context) => {
-      const authorization = await googleAuthorization(context.directory, instance.id);
-      if (authorization === null) return false;
-      return instance.services.every((service) =>
-        googleServiceAuthorized(authorization, googleServiceScopes(service)),
-      );
-    },
-    guided: async (instance, context) => {
-      for (const service of instance.services) {
-        try {
-          await authorizeGoogle(
-            {
-              directory: context.directory,
-              instance: instance.id,
-              client: context.dependencies.googleOAuthClient(),
-              scopes: googleServiceScopes(service),
-              approve: googleConsent(service, context),
-            },
-            context.dependencies.googleDependencies ?? {},
-          );
-        } catch (error) {
-          if (context.signal.aborted) return "cancelled";
-          if (error instanceof KitRefusal && error.code === "google_authorization_declined") {
-            return "cancelled";
-          }
-          return "failed";
-        }
-      }
-      return "ready";
-    },
-  },
-};
-
-export function connectorLogin(instance, dependencies = {}) {
-  return { ...CONNECTOR_LOGINS, ...(dependencies.connectorLogins ?? {}) }[instance.preset];
-}
-
-export async function signInConnector(options, dependencies = {}) {
+export async function signInConnector(options) {
   const configuration = await readConfiguration(options.configuration);
   const instance = sourceInstance(configuration, options.instance);
-  const gateway = connectorLogin(instance, dependencies);
-  if (gateway.login === undefined) {
-    throw new KitRefusal("kit_connector_login_guided", `${instance.id} signs in through House setup`);
-  }
   const context = { directory: options.directory, signal: options.signal };
-  if (await gateway.status(instance, context)) return "skipped";
-  return (await gateway.login(instance, context)) ? "ready" : "needs_attention";
+  if (await customAuthorizationStatus(instance, context)) return "skipped";
+  return (await authorizeCustom(instance, context)) ? "ready" : "needs_attention";
 }

package/src/contract.js

@@ -1,6 +1,6 @@
 import { CLAUDE_PASTED_CODE, CODEX_DEVICE_CODE, GROK_DEVICE_CODE } from "./agent-logins.js";
 
-export const KIT_CONTRACT_VERSION = "2026-09-26-house-agent-kinds";
+export const KIT_CONTRACT_VERSION = "3";
 export const KIT_CAPTURE_BATCH_MAX = 100;
 export const COMMAND_INPUT_MAX_BYTES = 4 * 1024;
 export const AUTHORIZATION_OUTPUT_MAX_BYTES = 4 * 1024;
@@ -21,10 +21,11 @@ export const COMMAND_ADAPTER_SESSION_TIMEOUT_MS = 30_000;
 export const WORKER_EXIT_GRACE_MS = 5_000;
 export const WORKER_EXIT_POLL_MS = 100;
 export const WORKER_SUPERVISION_POLL_MS = 2_000;
-export const WORKER_COMMAND_POLL_MS = 2_000;
-export const WORKER_HEARTBEAT_MS = 30_000;
 export const WORKER_COMMAND_BATCH_MAX = 10;
 export const WORKER_RUN_TOKEN_MARGIN_MS = 60_000;
+export const KIT_STREAM_RECONNECT_MS = 1_000;
+export const KIT_STREAM_RECONNECT_MAX_MS = 30_000;
+export const KIT_STREAM_REJOIN_MS = 2_000;
 export const TELEGRAM_IMAGE_UPLOAD_CEILING_BYTES = 10 * 1024 * 1024;
 export const CONVERSATION_FILE_TRANSFER_TIMEOUT_MS = 30_000;
 export const WORKER_INHERITED_ENVIRONMENT = ["PATH", "HOME"];
@@ -40,17 +41,15 @@ export function runOutcomePath(run) {
   return `/kit/runs/${encodeURIComponent(run)}/outcome`;
 }
 
+export function runRequestPath(run) {
+  return `/kit/runs/${encodeURIComponent(run)}/request`;
+}
+
 export const KIT_SESSIONS_REPORT_PATH = "/kit/sessions/report";
 export const KIT_SESSIONS_REPORT_MAX = 256;
 
-export const ASSISTANT_TEXT_MAX_BYTES = 4096;
-export const ASSISTANT_BLOCKS_MAX = 500;
 export const ASSISTANT_TABLE_COLUMNS_MAX = 20;
 
-export function assistantDraftsPath(workerSession) {
-  return `/kit/sessions/${encodeURIComponent(workerSession)}/drafts`;
-}
-
 export function assistantTextPath(workerSession) {
   return `/kit/sessions/${encodeURIComponent(workerSession)}/assistant-messages`;
 }
@@ -61,6 +60,8 @@ export const TELEGRAM_DELIVERY_BATCH_MAX = 10;
 export const TELEGRAM_DOWNLOAD_CEILING_BYTES = 20 * 1024 * 1024;
 export const TELEGRAM_BOT_API_TIMEOUT_MS = 30_000;
 export const TELEGRAM_GATEWAY_POLL_MS = 2_000;
+export const TELEGRAM_RICH_MESSAGE_CHARACTERS_MAX = 32_768;
+export const TELEGRAM_RICH_MESSAGE_BLOCKS_MAX = 500;
 export const TELEGRAM_CONTROL_KEYBOARD_COMMANDS = ["/stop", "/kill"];
 export const TELEGRAM_MEDIA_KINDS = [
   "document",
@@ -114,6 +115,10 @@ export const BRIDGE_NONCE_ENVIRONMENT = "HOUSE_KIT_BRIDGE_NONCE";
 export const BRIDGE_RECONNECT_MS = 200;
 export const BRIDGE_RECONNECT_MAX_MS = 5_000;
 
+export const HOUSE_CLI_LINE = "The agents.house house CLI is available: run house --help.";
+export const HOW_WE_WORK_PATH = "/private/library/how-we-work.md";
+export const SHELL_RENDER = "shell/1";
+
 export const ACP_PROTOCOL = 1;
 export const ACP_AUTH_REQUIRED = -32000;
 export const ADAPTER_EXIT_GRACE_MS = 2_000;
@@ -195,7 +200,7 @@ export const ADAPTER_CONTRACTS = Object.freeze({
     guidedLogin: CLAUDE_PASTED_CODE,
     identity: Object.freeze({ agentInfo: "@agentclientprotocol/claude-agent-acp" }),
     nativeQuestion: null,
-    sessionLoad: false,
+    sessionLoad: true,
     sessionConfig: Object.freeze({ model: "model", effort: "effort" }),
     capabilities: Object.freeze({
       field_kinds: ELICITATION_FIELD_KINDS,
@@ -251,6 +256,10 @@ export const KIT_LOGIN_REPORT_PATH = "/kit/logins/report";
 export const GUIDED_LOGIN_TIMEOUT_MS = 10 * 60 * 1000;
 export const GUIDED_LOGIN_OUTPUT_MAX_BYTES = 64 * 1024;
 
+export const KIT_SOURCES_DESIRED_PATH = "/kit/sources/desired";
+export const KIT_SOURCES_REPORT_PATH = "/kit/sources/report";
+export const SOURCE_CAPTURE_INTERVAL_MS = 15 * 60 * 1000;
+
 export const EXECUTION_AUTHORITIES = ["allow", "refuse"];
 
 export const PERMISSION_OPTION_KINDS = Object.freeze({
@@ -288,9 +297,25 @@ export const KIT_DOOR_DISCOVER_PATH = "/kit/door/discover";
 export const KIT_DOOR_BOOTSTRAP_PATH = "/kit/door/bootstrap";
 export const KIT_DOOR_ENUMERATE_PATH = "/kit/door/enumerate";
 export const KIT_DOOR_BATCH_PATH = "/kit/door/batch";
-export const EXPLICIT_SYNC_VERSION = "explicit-sync/1";
+export const KIT_DOOR_REVISIONS_PATH = "/kit/door/revisions";
+export const EXPLICIT_SYNC_VERSION = "explicit-sync/2";
 export const KIT_DOOR_UNMOUNT_PATH = "/kit/door/unmount";
 
+export const KIT_WORKING_COPY_SELECTION_PATH = "/kit/working-copy/selection";
+export const WORKING_COPY_VERSION = "working-copy-state/3";
+export const WORKING_COPIES_HOME = "working-copies";
+export const WORKING_COPY_ROOM_HOMES = ["capture", "library", "collaboration"];
+export const WORKING_COPY_PRIVATE_HOMES = ["library", "collaboration", "rooms", "agents", "house"];
+export const WORKING_COPY_RECEIVED_REF = "refs/house/received";
+export const WORKING_COPY_BRANCH = "main";
+export const ROOM_REFERENCE = /^r_[0-9a-z]+\.[0-9a-z]$/;
+export const WORKING_COPY_PUSH_METHOD = "house/git/push";
+export const WORKING_COPY_INDEX_METHOD = "house/git/index";
+export const WORKING_COPY_PUSH_HELP =
+  "Submit a Room commit to House; default HEAD. Use --owner only outside an Agent Session. Native git push is not a House remote.";
+export const WORKING_COPY_UPLOAD_COMMAND = "prepare_edit_upload";
+export const MCP_REQUEST_BODY_MAX_BYTES = 4 * 1024 * 1024;
+
 export const MIGRATOR_CONTRACT = "kit-migrator/1";
 export const MIGRATOR_CATEGORY = "migrator";
 export const MIGRATOR_MANIFEST = "migrator.json";

package/src/delivery.js

@@ -54,10 +54,8 @@ const FAILURE_CATEGORIES = {
   google_provider_unavailable: "provider",
   google_provider_response_invalid: "provider",
   google_checkpoint_invalid: "provider",
-  google_service_unsupported: "config",
-  google_oauth_client_unconfigured: "config",
-  google_drive_selection_exceeded: "config",
   google_drive_item_missing: "provider",
+  api_disabled: "config",
 };
 
 export function fileDescriptor(file) {
@@ -184,8 +182,7 @@ export function stallOf(code, houseRetry = null) {
 
 export function healthOfRun(stall) {
   if (stall === null) return { state: "ok", category: null };
-  return {
-    state: stall.disposition === "retry" ? "retrying" : "failed",
-    category: stall.category ?? FAILURE_CATEGORIES[stall.code] ?? "internal",
-  };
+  const category = stall.category ?? FAILURE_CATEGORIES[stall.code] ?? "internal";
+  if (stall.disposition === "retry") return { state: "retrying", category };
+  return { state: "failed", category, cause: stall.code };
 }

package/src/directory.js

@@ -1,10 +1,8 @@
 import { constants } from "node:fs";
-import { access, mkdir, realpath, rename, rm, stat } from "node:fs/promises";
-import { randomUUID } from "node:crypto";
-import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { access, mkdir, realpath, stat } from "node:fs/promises";
+import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
 import { LAUNCH_DIRECTORY_BASE } from "./contract.js";
 import { KitRefusal } from "./refusal.js";
-import { seedStarterSet } from "./starter-set.js";
 
 export function launchBase(dependencies = {}) {
   return dependencies.launchBase ?? LAUNCH_DIRECTORY_BASE;
@@ -39,25 +37,9 @@ function unavailable(path, cause) {
   return new KitRefusal("kit_launch_directory_unavailable", `${path} ${cause}`);
 }
 
-async function isDirectory(path) {
-  try {
-    return (await stat(path)).isDirectory();
-  } catch {
-    return false;
-  }
-}
-
-async function seedDefaultDirectory(selected, base, path) {
-  const staging = join(base, `.${randomUUID()}.staging`);
-  try {
-    await seedStarterSet(staging);
-    await rename(staging, path);
-  } catch (error) {
-    await rm(staging, { recursive: true, force: true }).catch(() => undefined);
-    if (!(await isDirectory(path))) {
-      throw unavailable(selected, `could not be prepared (${error.code ?? "unknown"})`);
-    }
-  }
+async function createDefaultDirectory(selected, path) {
+  const refused = await made(path);
+  if (refused !== null) throw unavailable(selected, `could not be created (${refused})`);
 }
 
 function within(base, selected) {
@@ -73,9 +55,7 @@ export async function readyLaunchDirectory(selected, base, agentId = null, optio
   if (options.container && !within(resolve(base), path)) {
     throw unavailable(selected, `resolves outside ${base}`);
   }
-  if (path === defaultDirectory(base, agentId) && !(await isDirectory(path))) {
-    await seedDefaultDirectory(selected, base, path);
-  }
+  if (path === defaultDirectory(base, agentId)) await createDefaultDirectory(selected, path);
   let described;
   try {
     described = await stat(path);

package/src/draft.js

@@ -1,89 +1,11 @@
-import { assistantBlocks, blocksText, withinAssistantBound } from "./blocks.js";
-
-const DRAFT_INTERVAL_MS = 500;
+import { pacedLatest } from "./pacing.js";
 
 export function observedAssistantDrafts(options) {
-  const intervalMs = options.intervalMs ?? DRAFT_INTERVAL_MS;
-  const now = options.now ?? (() => Date.now());
-  let timer = null;
-  let sentAt = null;
-  let sent = null;
-  let latest = null;
-
-  function write() {
-    timer = null;
-    if (latest === null || latest === sent) return;
-    sent = latest;
-    sentAt = now();
-    options.send(sent);
-  }
-
-  function cancel() {
-    if (timer === null) return;
-    clearTimeout(timer);
-    timer = null;
-  }
-
+  const paced = pacedLatest(options);
   return {
     observe(view) {
-      if (typeof view !== "string" || view === "") return;
-      latest = view;
-      if (timer !== null) return;
-      const wait = sentAt === null ? 0 : sentAt + intervalMs - now();
-      if (wait <= 0) {
-        write();
-        return;
-      }
-      timer = setTimeout(write, wait);
-      timer.unref?.();
-    },
-    complete(view) {
-      if (typeof view !== "string" || view === "") return;
-      latest = view;
-      cancel();
-      write();
-    },
-    close: cancel,
-  };
-}
-
-export function openAssistantDrafts(options) {
-  let pending = null;
-  let sending = null;
-  let sent = null;
-  let closed = false;
-
-  function pump() {
-    if (sending !== null || pending === null) return;
-    const view = pending;
-    pending = null;
-    sent = view.text;
-    let started;
-    try {
-      started = Promise.resolve(options.send(view.blocks));
-    } catch {
-      started = Promise.resolve();
-    }
-    sending = started
-      .catch(() => undefined)
-      .finally(() => {
-        sending = null;
-        pump();
-      });
-  }
-
-  return {
-    update(text) {
-      if (closed || typeof text !== "string" || text === "") return;
-      if (text === sent || text === pending?.text) return;
-      const blocks = assistantBlocks(text);
-      if (blocks === null || !withinAssistantBound(blocksText(blocks))) return;
-      pending = { text, blocks };
-      pump();
-    },
-    close() {
-      closed = true;
-      pump();
+      if (typeof view === "string" && view !== "") paced.observe(view);
     },
+    close: paced.close,
   };
 }