agentic-drive 0.5.0 → 0.6.0

package/dist/client.js

@@ -1,239 +1,7 @@
-// src/client.ts
-var DriveApiError = class extends Error {
-  constructor(code, status, message) {
-    super(message);
-    this.code = code;
-    this.status = status;
-    this.name = "DriveApiError";
-  }
-  code;
-  status;
-};
-var BASE = "/api/v1/drive";
-var CODES = {
-  NOT_FOUND: true,
-  NAME_TAKEN: true,
-  BLOB_EXISTS: true,
-  INVALID_NAME: true,
-  INVALID_PATH: true,
-  INVALID_REF: true,
-  NOT_A_FOLDER: true,
-  NOT_A_FILE: true,
-  MOVE_INTO_SELF: true,
-  TOO_DEEP: true,
-  PARENT_GONE: true,
-  TRASHED: true,
-  NOT_TRASHED: true,
-  IS_ROOT: true,
-  FORBIDDEN: true,
-  BLOB_MISSING: true,
-  TOO_LARGE: true,
-  INVALID_EXPIRY: true,
-  BUSY: true,
-  CROSS_DRIVE: true,
-  INVALID_SHARE: true,
-  TOO_MANY_ITEMS: true,
-  UNAUTHORIZED: true,
-  NOT_CONFIGURED: true,
-  INVALID_LINK: true,
-  INTERNAL: true
-};
-var KNOWN_CODES = new Set(Object.keys(CODES));
-var record = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
-var text = (v) => typeof v === "string";
-var orNull = (test) => (v) => v === null || test(v);
-var num = (v) => typeof v === "number";
-var ACTOR_KINDS = { human: true, agent_of_human: true, agent_of_agent: true, agent: true, user_token: true };
-var ROLES = ["viewer", "commenter", "editor", "owner"];
-var oneOf = (list) => (v) => typeof v === "string" && list.includes(v);
-var actor = (v) => record(v) && text(v.id) && oneOf(Object.keys(ACTOR_KINDS))(v.kind);
-var isItem = (v) => record(v) && text(v.id) && text(v.owner) && text(v.parentId) && text(v.name) && (v.kind === "folder" || v.kind === "file" || v.kind === "ref") && num(v.size) && orNull(text)(v.mime) && orNull(text)(v.hash) && orNull(text)(v.ref) && num(v.createdAt) && num(v.updatedAt) && actor(v.createdBy) && actor(v.updatedBy) && text(v.createdById) && text(v.updatedById) && typeof v.trashed === "boolean" && orNull(num)(v.trashedAt) && typeof v.machineMade === "boolean";
-var isPathItem = (v) => isItem(v) && typeof v.path === "string";
-var listOf = (check) => (v) => Array.isArray(v) && v.every(check);
-var shape = (test) => (v) => record(v) && test(v);
-var numbers = (...keys) => shape((v) => keys.every((k) => typeof v[k] === "number"));
-var isOk = shape((v) => v.ok === true);
-var RETRY_STATUS = /* @__PURE__ */ new Set([502, 503, 504]);
-function createClient(options) {
-  let origin;
-  try {
-    const url = new URL(options.baseUrl);
-    if (url.protocol !== "http:" && url.protocol !== "https:") throw new Error("not http");
-    origin = url.origin;
-  } catch {
-    throw new TypeError("baseUrl must be an http or https URL");
-  }
-  const { token } = options;
-  if (token !== void 0 && (typeof token !== "string" || !/^[A-Za-z0-9_-]{1,512}$/.test(token))) throw new TypeError("token must be 1 to 512 letters, digits, - or _");
-  const retries = options.retries ?? 0;
-  if (!Number.isInteger(retries) || retries < 0 || retries > 5) throw new RangeError("retries must be an integer from 0 to 5");
-  const doFetch = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
-  const query = (params) => {
-    const search = new URLSearchParams();
-    for (const [key, value] of Object.entries(params)) if (value !== void 0) search.set(key, String(value));
-    const text2 = search.toString();
-    return text2 === "" ? "" : `?${text2}`;
-  };
-  async function send(method, path, init) {
-    if (init.auth !== false && token === void 0) throw new TypeError("this call needs a token");
-    const headers = { ...token === void 0 ? {} : { authorization: `Bearer ${token}` }, ...init.headers };
-    let body = init.body;
-    if (init.json !== void 0) {
-      headers["content-type"] = "application/json";
-      body = JSON.stringify(init.json);
-    }
-    const attempts = method === "GET" ? retries + 1 : 1;
-    for (let attempt = 1; ; attempt++) {
-      let response;
-      try {
-        response = await doFetch(`${origin}${BASE}${path}`, { method, headers, body, signal: init.signal, redirect: "manual", ...body instanceof ReadableStream ? { duplex: "half" } : {} });
-      } catch (error) {
-        if (init.signal?.aborted || error instanceof Error && error.name === "AbortError") throw error;
-        if (attempt < attempts) {
-          await pause(attempt, init.signal);
-          continue;
-        }
-        const refused = body instanceof ReadableStream ? " (a stream body may be refused by this runtime: send bytes)" : "";
-        throw new DriveApiError("NETWORK_ERROR", 0, `${error instanceof Error ? `no answer: ${error.message}` : "no answer"}${refused}`);
-      }
-      if (attempt < attempts && RETRY_STATUS.has(response.status)) {
-        await response.body?.cancel();
-        await pause(attempt, init.signal);
-        continue;
-      }
-      if (response.type === "opaqueredirect" || response.status >= 300 && response.status < 400) {
-        await response.body?.cancel();
-        throw new DriveApiError("BAD_RESPONSE", response.status, "the server redirected. Set baseUrl to the final URL.");
-      }
-      if (response.ok) return response;
-      throw await errorOf(response, init.signal);
-    }
-  }
-  async function pause(attempt, signal) {
-    signal?.throwIfAborted();
-    await new Promise((resolve, reject) => {
-      const timer = setTimeout(() => {
-        signal?.removeEventListener("abort", stop);
-        resolve();
-      }, Math.min(100 * 2 ** (attempt - 1), 1e3));
-      const stop = () => {
-        clearTimeout(timer);
-        reject(signal?.reason);
-      };
-      signal?.addEventListener("abort", stop, { once: true });
-    });
-  }
-  async function errorOf(response, signal) {
-    let code = "BAD_RESPONSE";
-    let message = `the server answered ${response.status}`;
-    try {
-      const parsed = await response.json();
-      if (typeof parsed.error?.code === "string" && KNOWN_CODES.has(parsed.error.code)) code = parsed.error.code;
-      else if (typeof parsed.error?.code === "string") message = `the server answered ${response.status} with an unknown code, ${JSON.stringify(parsed.error.code.slice(0, 40))}`;
-      if (code !== "BAD_RESPONSE" && typeof parsed.error?.message === "string") message = parsed.error.message;
-    } catch (error) {
-      if (signal?.aborted) throw error;
-    }
-    return new DriveApiError(code, response.status, message);
-  }
-  async function json(method, path, init, check) {
-    const response = await send(method, path, init);
-    let value;
-    try {
-      value = await response.json();
-    } catch (error) {
-      if (init.signal?.aborted) throw error;
-      if (!(error instanceof SyntaxError)) throw new DriveApiError("NETWORK_ERROR", 0, "the connection dropped while the body came in");
-      throw new DriveApiError("BAD_RESPONSE", response.status, "the answer is not JSON");
-    }
-    if (!check(value)) throw new DriveApiError("BAD_RESPONSE", response.status, "the answer is not the shape that the API sends");
-    return value;
-  }
-  async function bytes(path, init, verify = false) {
-    const response = await send("GET", path, init);
-    let data;
-    try {
-      data = new Uint8Array(await response.arrayBuffer());
-    } catch (error) {
-      if (init.signal?.aborted) throw error;
-      throw new DriveApiError("NETWORK_ERROR", 0, "the connection dropped while the body came in");
-    }
-    const sha256 = response.headers.get("x-content-sha256") ?? "";
-    if (verify) {
-      if (!/^[0-9a-f]{64}$/.test(sha256)) throw new DriveApiError("BAD_RESPONSE", response.status, "the answer has no valid x-content-sha256");
-      if (typeof crypto === "undefined" || !crypto.subtle) throw new DriveApiError("BAD_RESPONSE", response.status, "this runtime has no WebCrypto, so the bytes cannot be checked. Use https.");
-      const digest = new Uint8Array(await crypto.subtle.digest("SHA-256", data));
-      if (Array.from(digest, (b) => b.toString(16).padStart(2, "0")).join("") !== sha256) throw new DriveApiError("BAD_RESPONSE", response.status, "the bytes do not match their hash");
-    }
-    return { data, contentType: response.headers.get("content-type") ?? "application/octet-stream", sha256 };
-  }
-  const link = (token2) => {
-    if (token2 === void 0) return void 0;
-    if (!/^[A-Za-z0-9_-]{1,512}$/.test(token2)) throw new TypeError("a link token has 1 to 512 letters, digits, - or _");
-    return { "x-link-token": token2 };
-  };
-  const id = (value) => {
-    if (typeof value !== "string" || !/^[A-Za-z0-9_-][A-Za-z0-9_.-]*$/.test(value) || value === "." || value === "..") throw new TypeError("an item id has letters, digits, -, _ and . (not first), and is not . or ..");
-    return value;
-  };
-  const isUrl = shape((v) => typeof v.url === "string" && /^https?:\/\//.test(v.url) && URL.canParse(v.url) && typeof v.expiresInSeconds === "number");
-  const isShares = shape(
-    (v) => listOf(shape((g) => (g.subjectKind === "human" || g.subjectKind === "agent") && text(g.subjectId) && oneOf(ROLES)(g.role)))(v.grants) && listOf(shape((l) => text(l.id) && oneOf(ROLES)(l.role) && typeof l.signedInOnly === "boolean" && orNull(num)(l.expiresAt) && typeof l.revoked === "boolean"))(v.links) && listOf(shape((i) => text(i.id) && oneOf(ROLES)(i.role) && orNull(text)(i.email) && orNull(text)(i.handle) && orNull(num)(i.expiresAt) && typeof i.accepted === "boolean"))(v.invites)
-  );
-  const isHome = shape((v) => record(v.apps) && Object.values(v.apps).every(num) && num(v.files) && listOf(shape((i) => isPathItem(i) && orNull(text)(i.app)))(v.items));
-  const isId = shape((v) => typeof v.id === "string");
-  const isLink = shape((v) => typeof v.id === "string" && typeof v.token === "string");
-  return {
-    /** The live items of a folder. */
-    list: (path = "/", o = {}) => json("GET", `/items${query({ path })}`, o, listOf(isItem)),
-    stat: (path, o = {}) => json("GET", `/stat${query({ path })}`, o, isItem),
-    mkdir: (path, opts = {}, o = {}) => json("POST", "/folders", { json: { path, parents: opts.parents === true }, ...o }, isItem),
-    /** Writes a file. A `ReadableStream` body streams in runtimes that allow it. */
-    upload: (path, body, opts = {}, o = {}) => json("PUT", `/files${query({ path, mime: opts.mime, parents: opts.parents === true ? true : void 0, onConflict: opts.onConflict })}`, {
-      body: typeof body === "string" ? new TextEncoder().encode(body) : body,
-      headers: { "content-type": "application/octet-stream" },
-      ...o
-    }, isItem),
-    /** The bytes. They are checked against the hash that the server sends. */
-    download: (path, o = {}) => bytes(`/files${query({ path })}`, o, true),
-    /** A signed link that works without a token, for `expires` seconds. You fetch the link yourself. */
-    url: (path, expires, o = {}) => json("GET", `/url${query({ path, expires })}`, o, isUrl),
-    move: (src, folder, opts = {}, o = {}) => json("POST", "/move", { json: { src, folder, ...opts }, ...o }, isItem),
-    trash: (path, o = {}) => json("POST", "/trash", { json: { path }, ...o }, isItem),
-    listTrash: (o = {}) => json("GET", "/trash", o, listOf(isItem)),
-    restore: (itemId, opts = {}, o = {}) => json("POST", "/restore", { json: { id: itemId, ...opts }, ...o }, isItem),
-    /** Deletes a trashed item for good. */
-    purge: (itemId, o = {}) => json("POST", "/purge", { json: { id: itemId }, ...o }, numbers("removed")),
-    search: (q = {}, o = {}) => json("GET", `/search${query(q)}`, o, listOf(isPathItem)),
-    /** Everything the caller has, as a zip. */
-    export: async (o = {}) => {
-      const { data } = await bytes("/export", o);
-      if (data[0] !== 80 || data[1] !== 75) throw new DriveApiError("BAD_RESPONSE", 200, "the answer is not a zip");
-      return data;
-    },
-    /** Erases the caller for good. The client sends `confirm=yes`. */
-    deleteAccount: (o = {}) => json("DELETE", "/account?confirm=yes", o, numbers("removed", "grants", "invites", "anonymized")),
-    home: (q = {}, o = {}) => json("GET", `/home${query(q)}`, o, isHome),
-    registerDocument: (input, o = {}) => json("POST", "/documents", { json: input, ...o }, isItem),
-    forgetDocument: (ref, o = {}) => json("DELETE", `/documents${query({ ref })}`, o, numbers("trashed")),
-    shares: (path, o = {}) => json("GET", `/shares${query({ path })}`, o, isShares),
-    share: (path, subject, role, o = {}) => json("POST", "/shares", { json: { path, subjectId: subject.id, subjectKind: subject.kind, role }, ...o }, isOk),
-    unshare: (path, subject, o = {}) => json("DELETE", `/shares${query({ path, subjectId: subject.id, subjectKind: subject.kind })}`, o, isOk),
-    /** Invite by `email` (a person) or `handle` (an agent). It sends no message. */
-    invite: (path, input, o = {}) => json("POST", "/invites", { json: { path, ...input }, ...o }, isId),
-    acceptInvite: (inviteId, o = {}) => json("POST", "/invites/accept", { json: { id: inviteId }, ...o }, isOk),
-    /** The token of a link comes back once. */
-    createLink: (path, input, o = {}) => json("POST", "/links", { json: { path, ...input }, ...o }, isLink),
-    revokeLink: (linkId, o = {}) => json("DELETE", `/links${query({ id: linkId })}`, o, isOk),
-    /** The next three read a shared item by id. Pass a link token, a bearer token, or both. */
-    openShared: async (itemId, opts = {}) => json("GET", `/shared/${id(itemId)}`, { auth: false, headers: link(opts.linkToken), signal: opts.signal }, isItem),
-    listShared: async (itemId, opts = {}) => json("GET", `/shared/${id(itemId)}/items`, { auth: false, headers: link(opts.linkToken), signal: opts.signal }, listOf(isItem)),
-    readShared: async (itemId, opts = {}) => {
-      const { data, contentType } = await bytes(`/shared/${id(itemId)}/content`, { auth: false, headers: link(opts.linkToken), signal: opts.signal });
-      return { data, contentType };
-    }
-  };
-}
+import {
+  DriveApiError,
+  createClient
+} from "./chunk-S4AGCKXW.js";
 export {
   DriveApiError,
   createClient

package/dist/{drive-Cn3mpuDW.d.ts → drive-BtRyexUP.d.ts}

@@ -200,7 +200,7 @@ declare function createDrive(deps: DriveDeps): {
     exportPerson(ctx: Ctx): Promise<{
         subject: {
             id: string;
-            kind: "human" | "agent" | "agent_of_human" | "agent_of_agent" | "user_token" | null;
+            kind: "human" | "agent_of_human" | "agent_of_agent" | "agent" | "user_token" | null;
         };
         partial: boolean;
         authored: {

package/dist/embed.css

@@ -0,0 +1,154 @@
+/* ui/app.css */
+.drive-main {
+  max-width: 72rem;
+}
+.drive-muted {
+  color: var(--ad-color-text-muted);
+}
+.drive-status {
+  display: flex;
+  align-items: center;
+  gap: var(--ad-space-2);
+  color: var(--ad-color-text-muted);
+}
+.drive-signin {
+  display: grid;
+  gap: var(--ad-space-4);
+  max-width: 24rem;
+}
+.drive-form {
+  display: grid;
+  gap: var(--ad-space-4);
+}
+.drive-form__actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: var(--ad-space-2);
+}
+.drive-drop {
+  min-height: 60vh;
+  border: 2px dashed transparent;
+  border-radius: var(--ad-radius-md);
+  padding: var(--ad-space-2);
+}
+.drive-drop--over {
+  border-color: var(--ad-color-accent);
+  background: var(--ad-color-accent-subtle);
+}
+.drive-bar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--ad-space-4);
+  flex-wrap: wrap;
+  margin-bottom: var(--ad-space-4);
+}
+.drive-bar h1 {
+  margin: 0;
+  font-size: var(--ad-font-size-xl);
+  overflow-wrap: anywhere;
+}
+.drive-crumbs ol {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--ad-space-2);
+  list-style: none;
+  margin: 0 0 var(--ad-space-2);
+  padding: 0;
+  color: var(--ad-color-text-muted);
+}
+.drive-crumbs li + li::before {
+  content: "/";
+  margin-right: var(--ad-space-2);
+}
+.drive-crumbs [aria-current=page] {
+  color: var(--ad-color-text);
+  font-weight: var(--ad-font-weight-semibold);
+}
+.drive-split {
+  display: grid;
+  grid-template-columns: 14rem minmax(0, 1fr);
+  gap: var(--ad-space-6);
+}
+@media (max-width: 48rem) {
+  .drive-split {
+    grid-template-columns: 1fr;
+  }
+}
+.drive-tree {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+.drive-tree .drive-tree {
+  padding-left: var(--ad-space-4);
+}
+.drive-tree a {
+  display: flex;
+  align-items: center;
+  gap: var(--ad-space-2);
+  padding: var(--ad-space-1) var(--ad-space-2);
+  border-radius: var(--ad-radius-sm);
+  color: var(--ad-color-text);
+  text-decoration: none;
+}
+.drive-tree a:hover {
+  background: var(--ad-color-surface-hover);
+}
+.drive-tree a[aria-current=page] {
+  background: var(--ad-color-accent-subtle);
+  color: var(--ad-color-accent-text);
+  font-weight: var(--ad-font-weight-semibold);
+}
+.drive-tree svg {
+  width: 1rem;
+  height: 1rem;
+  flex: none;
+}
+.drive-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(12rem, 1fr));
+  gap: var(--ad-space-4);
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+.drive-card {
+  position: relative;
+  display: grid;
+  gap: var(--ad-space-2);
+  padding: var(--ad-space-4);
+  border: 1px solid var(--ad-color-border);
+  border-radius: var(--ad-radius-md);
+  background: var(--ad-color-surface);
+}
+.drive-card__icon svg {
+  width: 2rem;
+  height: 2rem;
+}
+.drive-card__name {
+  overflow-wrap: anywhere;
+  font-weight: var(--ad-font-weight-medium);
+  color: var(--ad-color-text);
+}
+.drive-card__meta {
+  font-size: var(--ad-font-size-sm);
+  color: var(--ad-color-text-muted);
+}
+.drive-card__actions {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--ad-space-2);
+}
+.drive-root {
+  display: grid;
+  grid-template-columns: 12rem minmax(0, 1fr);
+  gap: var(--ad-space-6);
+  color: var(--ad-color-text);
+}
+@media (max-width: 48rem) {
+  .drive-root {
+    grid-template-columns: 1fr;
+  }
+}

package/dist/embed.d.ts

@@ -0,0 +1,21 @@
+import * as react from 'react';
+
+interface DriveUiOptions {
+    /** The address of the drive server, for example `https://drive.example.com`. Only its origin is used. */
+    baseUrl: string;
+    /** Returns the bearer token for the next request. It runs before every request, so it can refresh a token. No token sends no `authorization` header. */
+    getToken: () => string | undefined | Promise<string | undefined>;
+}
+/** The folders and trash of the signed-in caller, with upload, share, and the machine-made label. It needs the tooltip and toast providers above it. `mount` adds them.
+ * It shows the root again when `baseUrl` changes. A bad `baseUrl` or `getToken` throws. Pass a stable `getToken`, because a new function makes a new client. */
+declare function DriveBrowser({ baseUrl, getToken }: DriveUiOptions): react.JSX.Element | null;
+interface MountedDrive {
+    /** Show the drive with another address or token callback. The folder the person has open resets. */
+    update(options: DriveUiOptions): void;
+    /** Remove the UI. A request that runs is aborted, and no later request starts or calls `getToken`. Calling it again does nothing. */
+    unmount(): void;
+}
+/** Render the drive into an element, for an app that does not use React itself. A bad `baseUrl` or `getToken` throws a `TypeError`. */
+declare function mount(element: HTMLElement, options: DriveUiOptions): MountedDrive;
+
+export { DriveBrowser, type DriveUiOptions, type MountedDrive, mount };