@graview/core 0.1.0 → 0.1.3

package/dist/who.d.ts

@@ -1,6 +1,21 @@
 import type { Author } from "./ops/types.js";
 import type { Principal } from "./permissions/types.js";
 import type { AnySchema } from "./schema/schema.js";
+/**
+ * SOMEBODY THE APP MAY NAME, and nothing more (FR-13). A host knows the
+ * people of a hosted app, every member and every agent that has acted, and
+ * the app has no record of most of them. They are named through a
+ * directory, which is not a list of seats: a seat is somewhere a reader may
+ * sit, and a hosted reader sits only as who they signed in as.
+ */
+export interface Person {
+    /** The principal id the person acts under. */
+    readonly id: string;
+    /** What to call them. */
+    readonly name: string;
+    /** Said when one id could be a person and an agent; absent, any kind. */
+    readonly kind?: Principal["kind"];
+}
 /**
  * AN AUTHOR BY NAME. A principal's id is its user node's id where the app
  * has an installation; where it has seats and no installation, the seat
@@ -10,7 +25,7 @@ import type { AnySchema } from "./schema/schema.js";
  * been handed to the provider as "Lena, the label" and "June Arlo,
  * producer".
  */
-export declare function nameOfAuthor(author: Pick<Author, "kind" | "id">, where: {
+export declare function nameOfAuthor(author: Pick<Author, "kind" | "id" | "name" | "onBehalfOf">, where: {
     readonly graph: {
         getNode(id: string): ({
             id: string;
@@ -22,5 +37,13 @@ export declare function nameOfAuthor(author: Pick<Author, "kind" | "id">, where:
         readonly label: string;
         readonly principal: Principal;
     }[];
+    /** The host's directory of people, for authors nothing else here knows. */
+    readonly people?: readonly Person[];
 }): string;
+/**
+ * THE CHANNEL, IN WORDS: "via Claude" for `mcp:Claude`, "via the API".
+ * Nothing for `web` — a person at the interface is the ordinary case, and
+ * saying so beside every line would be noise.
+ */
+export declare function viaSaid(via: string | undefined): string | undefined;
 //# sourceMappingURL=who.d.ts.map

package/dist/who.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"who.d.ts","sourceRoot":"","sources":["../src/who.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EACnC,KAAK,EAAE;IACL,QAAQ,CAAC,KAAK,EAAE;QAAE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAA;KAAE,CAAC;IAC9G,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;KAAE,EAAE,CAAC;CACvF,GACA,MAAM,CAMR"}
+{"version":3,"file":"who.d.ts","sourceRoot":"","sources":["../src/who.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,WAAW,MAAM;IACrB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,YAAY,CAAC,EAC3D,KAAK,EAAE;IACL,QAAQ,CAAC,KAAK,EAAE;QAAE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAA;KAAE,CAAC;IAC9G,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;KAAE,EAAE,CAAC;IACtF,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,GACA,MAAM,CA4BR;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CASnE"}

package/dist/who.js

@@ -9,12 +9,59 @@ import { labelOf } from "./schema/define-node.js";
  * producer".
  */
 export function nameOfAuthor(author, where) {
+    /*
+     * FOR WHOM. An agent acting for a person is both of them — "Claude, for
+     * Nick" — in the rail and in history alike (FR-06).
+     */
+    if (author.onBehalfOf) {
+        const { onBehalfOf, ...itself } = author;
+        return `${nameOfAuthor(itself, where)}, for ${nameOfAuthor(onBehalfOf, where)}`;
+    }
     if (author.id === undefined)
-        return author.kind === "agent" ? "an agent" : author.kind;
+        return author.name ?? (author.kind === "agent" ? "an agent" : author.kind);
     const node = where.graph.getNode(author.id);
     if (node)
         return labelOf(where.schema.tryDefinition(node.kind), node);
     const seat = where.seats?.find((one) => one.principal.id === author.id);
-    return seat?.label ?? author.id;
+    if (seat)
+        return seat.label;
+    const person = where.people?.find((one) => one.id === author.id && (one.kind === undefined || one.kind === author.kind));
+    if (person)
+        return person.name;
+    // The author's own name, where nothing here knows them: another person in a hosted app, an agent from a chat (FR-17).
+    if (author.name)
+        return author.name;
+    /*
+     * NEVER THE ID. An author nothing names — the store's own migration
+     * ("ship:migration"), a seat the app did not list, a sync — is said by
+     * what it is; its id is an identifier, and the activity rail printed
+     * "ship:migration" above the upgrade it made (the seventh walk).
+     */
+    if (/(^|:)migration$/.test(author.id))
+        return "the upgrade";
+    // A plain name ("kai") is how a host without seats names somebody; a namespaced id is not a name.
+    if (/[:_/]/.test(author.id))
+        return { human: "somebody", agent: "an agent", rule: "a rule", system: "the system" }[author.kind];
+    return author.id;
+}
+/**
+ * THE CHANNEL, IN WORDS: "via Claude" for `mcp:Claude`, "via the API".
+ * Nothing for `web` — a person at the interface is the ordinary case, and
+ * saying so beside every line would be noise.
+ */
+export function viaSaid(via) {
+    if (via === undefined || via === "web")
+        return undefined;
+    if (via === "api")
+        return "via the API";
+    if (via === "cli")
+        return "via the command line";
+    const [channel, ...rest] = via.split(":");
+    const name = rest.join(":");
+    if ((channel === "mcp" || channel === "view") && name)
+        return `via ${name}`;
+    if (channel === "mcp")
+        return "via an agent's tools";
+    return `via ${via}`;
 }
 //# sourceMappingURL=who.js.map

package/dist/who.js.map

@@ -1 +1 @@
-{"version":3,"file":"who.js","sourceRoot":"","sources":["../src/who.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGlD;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAmC,EACnC,KAIC;IAED,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;IACvF,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5C,IAAI,IAAI;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;IACxE,OAAO,IAAI,EAAE,KAAK,IAAI,MAAM,CAAC,EAAE,CAAC;AAClC,CAAC"}
+{"version":3,"file":"who.js","sourceRoot":"","sources":["../src/who.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAmBlD;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,MAA2D,EAC3D,KAMC;IAED;;;OAGG;IACH,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;QACzC,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC;IAClF,CAAC;IACD,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxG,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5C,IAAI,IAAI;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;IACxE,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC;IAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACzH,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IAC/B,sHAAsH;IACtH,IAAI,MAAM,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IACpC;;;;;OAKG;IACH,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAAE,OAAO,aAAa,CAAC;IAC5D,kGAAkG;IAClG,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChI,OAAO,MAAM,CAAC,EAAE,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,GAAuB;IAC7C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,KAAK;QAAE,OAAO,SAAS,CAAC;IACzD,IAAI,GAAG,KAAK,KAAK;QAAE,OAAO,aAAa,CAAC;IACxC,IAAI,GAAG,KAAK,KAAK;QAAE,OAAO,sBAAsB,CAAC;IACjD,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,OAAO,OAAO,IAAI,EAAE,CAAC;IAC5E,IAAI,OAAO,KAAK,KAAK;QAAE,OAAO,sBAAsB,CAAC;IACrD,OAAO,OAAO,GAAG,EAAE,CAAC;AACtB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graview/core",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -9,6 +9,14 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./document": {
+      "types": "./dist/document/index.d.ts",
+      "default": "./dist/document/index.js"
+    },
+    "./conformance": {
+      "types": "./dist/conformance/index.d.ts",
+      "default": "./dist/conformance/index.js"
+    },
     "./sqlite": {
       "types": "./dist/persistence/sqlite.d.ts",
       "default": "./dist/persistence/sqlite.js"