@astrale-os/kernel-client 0.2.4 → 0.3.1

package/dist/graph/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/graph/api.ts"],"names":[],"mappings":"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"}

package/dist/graph/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Graph sugar over the two batch syscalls (`function.get`/`function.mutate`).
+ *
+ * One implementation, bound per context: the shell exposes it as
+ * `shell.kernel.graph`, the SDK as the handler's `ctx.graph`, and a bound
+ * client session flattens it directly onto the view (`session.as(cred).get`,
+ * `.query`, `.mutate`, …). Pure over a `GraphCall`
+ * capability — no client state, no transport opinion.
+ *
+ * Layout: `api.ts`, `query/`, `result/`, `mutate/`, `wire.ts`, and `named.ts`.
+ */
+export { createGraph, KERNEL_GET_PATH, KERNEL_MUTATE_PATH } from './api';
+export type { CreateGraphOpts, GraphApi, GraphCall, MutateFn, QueryFn } from './api';
+export type { EdgeBuilderInput, NodeRef, PatchBuilder, PatchInput, Ref, WriteShorthands, } from './mutate';
+export { F, InvalidQueryError, lowerToGet, makeReadShorthands, Q, resolveNeighbors, UnsupportedQueryError, } from './query';
+export type { ChildrenOpts, EdgeInput, ExpandInput, FilterInput, GatherBuilder, HopOpts, LoweringCapability, LoweringPhase, NeighborsRead, OrderInput, QueryBuilder, QuerySource, ReadShorthands, TraverseCtx, TraverseNode, WalkOpts, } from './query';
+export { makeGraphResult, makePaged, nextQuery, NotImplementedError } from './result';
+export type { Content, GraphResult, Page, Paged } from './result';
+export { DESCRIPTION_KEY, NAME_KEY, STATUS_KEY, descriptionOf, nameOf, statusOf } from './named';
+export type { NamedNodeLike } from './named';
+export { edgeKey, prop, rawOf } from './wire';
+export type { EdgeIdentity, GetNextCursors, GetResultWire, GraphEdgeWire, GraphNodeWire, MutationResultWire, } from './wire';
+export type { ChildrenSelectorInput, EdgeKey, EdgeMatch, EdgeRef, EdgeSelectorInput, EdgeWire, Expand, Filter, GetInput, GetOutput, GetOutputWire, GraphData, GraphDataWire, MutationResult, NodeWire, PatchData, PatchDataInput, PathLike, PermName, Properties, PropertyValue, QueryAST, QueryASTInput, QueryDir, QueryOrder, QueryPage, QueryRoot, QueryStep, Wire, } from '@astrale-os/kernel-core';
+//# sourceMappingURL=index.d.ts.map

package/dist/graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAA;AACxE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AACpF,YAAY,EACV,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,UAAU,EACV,GAAG,EACH,eAAe,GAChB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,CAAC,EACD,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,CAAC,EACD,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,SAAS,CAAA;AAChB,YAAY,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EACX,WAAW,EACX,aAAa,EACb,OAAO,EACP,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,UAAU,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,EACX,YAAY,EACZ,QAAQ,GACT,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AACrF,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAGjE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAChG,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAC7C,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,kBAAkB,GACnB,MAAM,QAAQ,CAAA;AAIf,YAAY,EACV,qBAAqB,EACrB,OAAO,EACP,SAAS,EACT,OAAO,EACP,iBAAiB,EACjB,QAAQ,EACR,MAAM,EACN,MAAM,EACN,QAAQ,EACR,SAAS,EACT,aAAa,EACb,SAAS,EACT,aAAa,EACb,cAAc,EACd,QAAQ,EACR,SAAS,EACT,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,aAAa,EACb,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,IAAI,GACL,MAAM,yBAAyB,CAAA"}

package/dist/graph/index.js

@@ -0,0 +1,20 @@
+/**
+ * Graph sugar over the two batch syscalls (`function.get`/`function.mutate`).
+ *
+ * One implementation, bound per context: the shell exposes it as
+ * `shell.kernel.graph`, the SDK as the handler's `ctx.graph`, and a bound
+ * client session flattens it directly onto the view (`session.as(cred).get`,
+ * `.query`, `.mutate`, …). Pure over a `GraphCall`
+ * capability — no client state, no transport opinion.
+ *
+ * Layout: `api.ts`, `query/`, `result/`, `mutate/`, `wire.ts`, and `named.ts`.
+ */
+export { createGraph, KERNEL_GET_PATH, KERNEL_MUTATE_PATH } from './api';
+// ─── Query tier — builder, filter kit, lowering ──────────────────────────────
+export { F, InvalidQueryError, lowerToGet, makeReadShorthands, Q, resolveNeighbors, UnsupportedQueryError, } from './query';
+// ─── Result tier — live reads, pagers, cursor folds ──────────────────────────
+export { makeGraphResult, makePaged, nextQuery, NotImplementedError } from './result';
+// ─── Universal-prop helpers (blessed; single-sourced from K) ─────────────────
+export { DESCRIPTION_KEY, NAME_KEY, STATUS_KEY, descriptionOf, nameOf, statusOf } from './named';
+export { edgeKey, prop, rawOf } from './wire';
+//# sourceMappingURL=index.js.map

package/dist/graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAA;AAWxE,gFAAgF;AAChF,OAAO,EACL,CAAC,EACD,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,CAAC,EACD,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,SAAS,CAAA;AAoBhB,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAGrF,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAGhG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA"}

package/dist/graph/mutate/builder.d.ts

@@ -0,0 +1,108 @@
+/**
+ * The fluent patch builder handed to `graph.mutate((m) => …)`.
+ *
+ * String-first: it accumulates a wire `PatchDataInput` (raw path strings);
+ * path resolution happens server-side in the `function.mutate` resolver.
+ * Lifetime is the builder callback — nothing is sent until it returns, the
+ * accumulated patch commits as ONE atomic `function.mutate`, and a throw
+ * inside the callback writes nothing. Reads done while building are not part
+ * of the atom.
+ */
+import type { PatchDataInput, PathLike, Properties } from '@astrale-os/kernel-core';
+/**
+ * Patch accepted by `build()` and by `mutate` — the input side of the server's
+ * own `patchDataSchema`: arms optional, path fields accept strings or `Path`s,
+ * `props` REQUIRED on create/update arms (an explicit `{}` is the contract).
+ */
+export type PatchInput = PatchDataInput;
+/**
+ * Anything addressable inside the builder: a raw wire string, a typed `Path`,
+ * or a {@link NodeRef} handed back by an earlier `createNode`. All three expose
+ * a raw form, so they normalize identically.
+ */
+export type Ref = PathLike | NodeRef;
+/**
+ * A handle to a node the builder is creating. Usable anywhere a {@link Ref} is
+ * accepted (as another op's `at`, `source`, or `target`) — the server resolves
+ * it by path, so no client-minted id is needed. `.id` is the minted id, back-
+ * filled after the mutate commits; reading it before then throws.
+ */
+export interface NodeRef {
+    /** The node's `at` path (raw). Makes the ref usable as a {@link Ref}. */
+    readonly raw: string;
+    /** Friendly alias of {@link raw}. */
+    readonly path: string;
+    /** Address a descendant that will be created under this node. */
+    child(slug: string): NodeRef;
+    /**
+     * The minted node id. Available only AFTER `await graph.mutate(...)` resolves;
+     * reading it inside the builder (or for a path this builder didn't create)
+     * throws.
+     */
+    readonly id: string;
+    toString(): string;
+}
+/** Edge shape accepted by the builder — {@link Ref} endpoints, optional props. */
+export interface EdgeBuilderInput {
+    readonly class: Ref;
+    readonly source: Ref;
+    readonly slug?: string;
+    readonly target: Ref;
+    readonly props?: Properties;
+}
+/**
+ * Fluent, chainable patch builder. Mirrors the six `function.mutate` arms with
+ * full semantic verbs, plus `link` / `unlink` sugar over edge create / delete.
+ * `createNode` returns a {@link NodeRef}; every other method returns `this`.
+ */
+export interface PatchBuilder {
+    createNode(cls: Ref, at: Ref, props?: Properties): NodeRef;
+    updateNode(cls: Ref, path: Ref, props: Properties): this;
+    deleteNode(cls: Ref, path: Ref): this;
+    createEdge(edge: EdgeBuilderInput): this;
+    updateEdge(edge: EdgeBuilderInput & {
+        props: Properties;
+    }): this;
+    deleteEdge(edge: Omit<EdgeBuilderInput, 'props'>): this;
+    /** Sugar over `createEdge`, sentence-order: `link(source, class, target)`. */
+    link(source: Ref, cls: Ref, target: Ref, opts?: {
+        slug?: string;
+        props?: Properties;
+    }): this;
+    /** Sugar over `deleteEdge`, sentence-order: `unlink(source, class, target)`. */
+    unlink(source: Ref, cls: Ref, target: Ref, opts?: {
+        slug?: string;
+    }): this;
+}
+/** Normalize any {@link Ref} to its raw string — string, `Path`, or `NodeRef`. */
+export declare function refRaw(x: Ref): string;
+/**
+ * The concrete builder. Internal to the graph module: `createGraph`
+ * instantiates one per `mutate(callback)`, runs the callback, `build()`s the
+ * wire patch, commits it, then `resolve()`s the minted ids into the refs.
+ */
+export declare class PatchBuilderImpl implements PatchBuilder {
+    private readonly _nodes;
+    private readonly _edges;
+    private readonly _res;
+    createNode(cls: Ref, at: Ref, props?: Properties): NodeRef;
+    updateNode(cls: Ref, path: Ref, props: Properties): this;
+    deleteNode(cls: Ref, path: Ref): this;
+    createEdge(edge: EdgeBuilderInput): this;
+    updateEdge(edge: EdgeBuilderInput & {
+        props: Properties;
+    }): this;
+    deleteEdge(edge: Omit<EdgeBuilderInput, 'props'>): this;
+    link(source: Ref, cls: Ref, target: Ref, opts?: {
+        slug?: string;
+        props?: Properties;
+    }): this;
+    unlink(source: Ref, cls: Ref, target: Ref, opts?: {
+        slug?: string;
+    }): this;
+    /** The accumulated wire patch — all six arms present (empty when unused). */
+    build(): PatchInput;
+    /** Back-fill minted node ids so returned `NodeRef.id` resolves. */
+    resolve(minted: Record<string, string>): void;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/graph/mutate/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/graph/mutate/builder.ts"],"names":[],"mappings":"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"}

package/dist/graph/mutate/builder.js

@@ -0,0 +1,127 @@
+/**
+ * The fluent patch builder handed to `graph.mutate((m) => …)`.
+ *
+ * String-first: it accumulates a wire `PatchDataInput` (raw path strings);
+ * path resolution happens server-side in the `function.mutate` resolver.
+ * Lifetime is the builder callback — nothing is sent until it returns, the
+ * accumulated patch commits as ONE atomic `function.mutate`, and a throw
+ * inside the callback writes nothing. Reads done while building are not part
+ * of the atom.
+ */
+/** Normalize any {@link Ref} to its raw string — string, `Path`, or `NodeRef`. */
+export function refRaw(x) {
+    return typeof x === 'string' ? x : x.raw;
+}
+class NodeRefImpl {
+    raw;
+    res;
+    constructor(raw, res) {
+        this.raw = raw;
+        this.res = res;
+    }
+    get path() {
+        return this.raw;
+    }
+    child(slug) {
+        const base = this.raw === '/' ? '' : this.raw;
+        return new NodeRefImpl(`${base}/${slug}`, this.res);
+    }
+    get id() {
+        if (!this.res.minted) {
+            throw new Error(`NodeRef.id for "${this.raw}" is available only after the mutate commits — ` +
+                'read it after `await graph.mutate(...)`, not inside the builder callback.');
+        }
+        const id = this.res.minted[this.raw];
+        if (id === undefined) {
+            throw new Error(`NodeRef.id: no node was created at "${this.raw}" in this mutate — ` +
+                '.id is defined only for paths this builder created.');
+        }
+        return id;
+    }
+    toString() {
+        return this.raw;
+    }
+}
+/**
+ * The concrete builder. Internal to the graph module: `createGraph`
+ * instantiates one per `mutate(callback)`, runs the callback, `build()`s the
+ * wire patch, commits it, then `resolve()`s the minted ids into the refs.
+ */
+export class PatchBuilderImpl {
+    _nodes = {
+        create: [],
+        update: [],
+        delete: [],
+    };
+    _edges = {
+        create: [],
+        update: [],
+        delete: [],
+    };
+    _res = {};
+    createNode(cls, at, props) {
+        const atRaw = refRaw(at);
+        this._nodes.create.push({ class: refRaw(cls), at: atRaw, props: props ?? {} });
+        return new NodeRefImpl(atRaw, this._res);
+    }
+    updateNode(cls, path, props) {
+        this._nodes.update.push({ class: refRaw(cls), path: refRaw(path), props });
+        return this;
+    }
+    deleteNode(cls, path) {
+        this._nodes.delete.push({ class: refRaw(cls), path: refRaw(path) });
+        return this;
+    }
+    createEdge(edge) {
+        this._edges.create.push(rawEdge(edge, edge.props ?? {}));
+        return this;
+    }
+    updateEdge(edge) {
+        this._edges.update.push(rawEdge(edge, edge.props));
+        return this;
+    }
+    deleteEdge(edge) {
+        this._edges.delete.push(rawIdentity(edge));
+        return this;
+    }
+    link(source, cls, target, opts) {
+        return this.createEdge({
+            class: cls,
+            source,
+            target,
+            ...(opts?.slug !== undefined && { slug: opts.slug }),
+            ...(opts?.props !== undefined && { props: opts.props }),
+        });
+    }
+    unlink(source, cls, target, opts) {
+        return this.deleteEdge({
+            class: cls,
+            source,
+            target,
+            ...(opts?.slug !== undefined && { slug: opts.slug }),
+        });
+    }
+    /** The accumulated wire patch — all six arms present (empty when unused). */
+    build() {
+        return { nodes: this._nodes, edges: this._edges };
+    }
+    /** Back-fill minted node ids so returned `NodeRef.id` resolves. */
+    resolve(minted) {
+        this._res.minted = minted;
+    }
+}
+// ─── helpers ─────────────────────────────────────────────────────────────────
+/** Edge identity → raw wire tuple, `slug` omitted when absent. */
+function rawIdentity(edge) {
+    return {
+        class: refRaw(edge.class),
+        source: refRaw(edge.source),
+        ...(edge.slug !== undefined && { slug: edge.slug }),
+        target: refRaw(edge.target),
+    };
+}
+/** Edge identity + props → raw wire edge record. */
+function rawEdge(edge, props) {
+    return { ...rawIdentity(edge), props };
+}
+//# sourceMappingURL=builder.js.map

package/dist/graph/mutate/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../src/graph/mutate/builder.ts"],"names":[],"mappings":"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"}

package/dist/graph/mutate/index.d.ts

@@ -0,0 +1,5 @@
+export { PatchBuilderImpl, refRaw } from './builder';
+export type { EdgeBuilderInput, NodeRef, PatchBuilder, PatchInput, Ref } from './builder';
+export { makeWriteShorthands, mintedId } from './shorthands';
+export type { WriteShorthands } from './shorthands';
+//# sourceMappingURL=index.d.ts.map

package/dist/graph/mutate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/graph/mutate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACpD,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACzF,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5D,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/dist/graph/mutate/index.js

@@ -0,0 +1,3 @@
+export { PatchBuilderImpl, refRaw } from './builder';
+export { makeWriteShorthands, mintedId } from './shorthands';
+//# sourceMappingURL=index.js.map

package/dist/graph/mutate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graph/mutate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAEpD,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA"}

package/dist/graph/mutate/shorthands.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The one-op write shorthands — each a loss-less one-arm `function.mutate`.
+ * Loss-less because a write returns an *outcome*, not a session: a minted id
+ * (create) or nothing (update/delete), so no envelope is stripped.
+ *
+ * Factored over a bare `commit` (the value-form mutate) rather than the whole
+ * `GraphApi`, so this module never imports the surface it helps build.
+ */
+import type { EdgeIdentity, PathLike, Properties } from '@astrale-os/kernel-core';
+import type { MutationResultWire } from '../wire';
+import type { PatchInput } from './builder';
+/** The write half of {@link GraphApi} — kept as its own contract so `GraphApi` can extend it. */
+export interface WriteShorthands {
+    /** Create one node; resolves to the minted node id. */
+    createNode(cls: PathLike, at: PathLike, props?: Properties): Promise<string>;
+    /** Update one node's props. */
+    updateNode(cls: PathLike, path: PathLike, props: Properties): Promise<void>;
+    /** Delete one node (leaf-guarded — batch deletes drain subtrees atomically). */
+    deleteNode(cls: PathLike, path: PathLike): Promise<void>;
+    /** Create one edge; resolves to the minted edge id. */
+    createEdge(edge: EdgeIdentity & {
+        props?: Properties;
+    }): Promise<string>;
+    /** Update one edge's props. */
+    updateEdge(edge: EdgeIdentity & {
+        props: Properties;
+    }): Promise<void>;
+    /** Delete one edge by identity tuple. */
+    deleteEdge(edge: EdgeIdentity): Promise<void>;
+}
+/** A value-form `function.mutate` — the one capability the shorthands need. */
+type Commit = (patch: PatchInput) => Promise<MutationResultWire>;
+/** Build the six write shorthands over a value-form mutate. */
+export declare function makeWriteShorthands(commit: Commit): WriteShorthands;
+/**
+ * Look up a minted id by its request key; when hydration normalized the key,
+ * a single-entry map is unambiguous — use it. Throws on a genuine miss rather
+ * than return the request key (a path/edge-key masquerading as a minted id).
+ */
+export declare function mintedId(map: Record<string, string>, key: string, kind: 'node' | 'edge'): string;
+export {};
+//# sourceMappingURL=shorthands.d.ts.map

package/dist/graph/mutate/shorthands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shorthands.d.ts","sourceRoot":"","sources":["../../../src/graph/mutate/shorthands.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAI3C,iGAAiG;AACjG,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC5E,+BAA+B;IAC/B,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3E,gFAAgF;IAChF,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxD,uDAAuD;IACvD,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG;QAAE,KAAK,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACxE,+BAA+B;IAC/B,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG;QAAE,KAAK,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrE,yCAAyC;IACzC,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9C;AAED,+EAA+E;AAC/E,KAAK,MAAM,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;AAEhE,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAkCnE;AAmBD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAMhG"}

package/dist/graph/mutate/shorthands.js

@@ -0,0 +1,65 @@
+/**
+ * The one-op write shorthands — each a loss-less one-arm `function.mutate`.
+ * Loss-less because a write returns an *outcome*, not a session: a minted id
+ * (create) or nothing (update/delete), so no envelope is stripped.
+ *
+ * Factored over a bare `commit` (the value-form mutate) rather than the whole
+ * `GraphApi`, so this module never imports the surface it helps build.
+ */
+import { edgeKey, rawOf } from '../wire';
+/** Build the six write shorthands over a value-form mutate. */
+export function makeWriteShorthands(commit) {
+    return {
+        async createNode(cls, at, props) {
+            const atRaw = rawOf(at);
+            const result = await commit({
+                nodes: { create: [{ class: rawOf(cls), at: atRaw, props: props ?? {} }] },
+            });
+            return mintedId(result.createdNodes, atRaw, 'node');
+        },
+        async updateNode(cls, path, props) {
+            await commit({ nodes: { update: [{ class: rawOf(cls), path: rawOf(path), props }] } });
+        },
+        async deleteNode(cls, path) {
+            await commit({ nodes: { delete: [{ class: rawOf(cls), path: rawOf(path) }] } });
+        },
+        async createEdge(edge) {
+            const { props, ...rest } = edge;
+            const identity = rawIdentity(rest);
+            const result = await commit({ edges: { create: [{ ...identity, props: props ?? {} }] } });
+            return mintedId(result.createdEdges, edgeKey(identity), 'edge');
+        },
+        async updateEdge(edge) {
+            const { props, ...rest } = edge;
+            await commit({ edges: { update: [{ ...rawIdentity(rest), props }] } });
+        },
+        async deleteEdge(edge) {
+            await commit({ edges: { delete: [rawIdentity(edge)] } });
+        },
+    };
+}
+// ─── Internals ───────────────────────────────────────────────────────────────
+/** Normalize an edge identity's `PathLike` fields to raw wire strings. */
+function rawIdentity(edge) {
+    return {
+        class: rawOf(edge.class),
+        source: rawOf(edge.source),
+        ...(edge.slug !== undefined ? { slug: edge.slug } : {}),
+        target: rawOf(edge.target),
+    };
+}
+/**
+ * Look up a minted id by its request key; when hydration normalized the key,
+ * a single-entry map is unambiguous — use it. Throws on a genuine miss rather
+ * than return the request key (a path/edge-key masquerading as a minted id).
+ */
+export function mintedId(map, key, kind) {
+    const exact = map[key];
+    if (exact)
+        return exact;
+    const values = Object.values(map);
+    if (values.length === 1)
+        return values[0];
+    throw new Error(`function.mutate minted no ${kind} id for "${key}"`);
+}
+//# sourceMappingURL=shorthands.js.map

package/dist/graph/mutate/shorthands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shorthands.js","sourceRoot":"","sources":["../../../src/graph/mutate/shorthands.ts"],"names":[],"mappings":"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"}

package/dist/graph/named.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Blessed universal-prop helpers (FRONTEND/SHELL_REACT §G8).
+ *
+ * Every node inherits the kernel `Named`/`Descriptable`/`Statused` mixins, so
+ * their qualified prop keys and readers belong to one place — single-sourced
+ * from the compiled kernel schema `K` accessor, never a hand-written literal
+ * that could drift. Replaces the per-repo copies (the GUI's hardcoded prefix,
+ * the workspace domain's `keys.ts`).
+ */
+import type { Properties } from '@astrale-os/kernel-core';
+/** Qualified key of the `Named.name` prop — the universal display name. */
+export declare const NAME_KEY: `${import("@astrale-os/kernel-core/domain").DomainOrigin}:interface.Named.property.name`;
+/** Qualified key of the `Descriptable.description` prop. */
+export declare const DESCRIPTION_KEY: `${import("@astrale-os/kernel-core/domain").DomainOrigin}:interface.Descriptable.property.description`;
+/** Qualified key of the `Statused.status` prop. */
+export declare const STATUS_KEY: `${import("@astrale-os/kernel-core/domain").DomainOrigin}:interface.Statused.property.status`;
+/**
+ * The minimal node projection these helpers read — satisfied by both a typed
+ * kernel `Node` (`path` an `AbsolutePath`) and a wire `NodeWire` (`path` a raw
+ * string), so the same reader serves the surface and the store internals.
+ */
+export interface NamedNodeLike {
+    readonly props: Properties;
+    readonly path: {
+        basename?(): string | null;
+        raw?: string;
+    } | string;
+}
+/**
+ * A node's display name: its `Named.name` when set, else the last path segment,
+ * else the raw path. Always a non-empty string for a real node.
+ */
+export declare function nameOf(node: NamedNodeLike): string;
+/** A node's `Descriptable.description`, or `undefined` when unset. */
+export declare function descriptionOf(node: Pick<NamedNodeLike, 'props'>): string | undefined;
+/** A node's `Statused.status`, or `undefined` when unset. */
+export declare function statusOf(node: Pick<NamedNodeLike, 'props'>): string | undefined;
+//# sourceMappingURL=named.d.ts.map

package/dist/graph/named.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"named.d.ts","sourceRoot":"","sources":["../../src/graph/named.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAIzD,2EAA2E;AAC3E,eAAO,MAAM,QAAQ,0FAAmB,CAAA;AAExC,4DAA4D;AAC5D,eAAO,MAAM,eAAe,wGAAiC,CAAA;AAE7D,mDAAmD;AACnD,eAAO,MAAM,UAAU,+FAAwB,CAAA;AAE/C;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,IAAI,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAA;CACrE;AAmBD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAElD;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAEpF;AAED,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAE/E"}

package/dist/graph/named.js

@@ -0,0 +1,47 @@
+/**
+ * Blessed universal-prop helpers (FRONTEND/SHELL_REACT §G8).
+ *
+ * Every node inherits the kernel `Named`/`Descriptable`/`Statused` mixins, so
+ * their qualified prop keys and readers belong to one place — single-sourced
+ * from the compiled kernel schema `K` accessor, never a hand-written literal
+ * that could drift. Replaces the per-repo copies (the GUI's hardcoded prefix,
+ * the workspace domain's `keys.ts`).
+ */
+import { K } from '@astrale-os/kernel-core';
+/** Qualified key of the `Named.name` prop — the universal display name. */
+export const NAME_KEY = K.Named.name.key;
+/** Qualified key of the `Descriptable.description` prop. */
+export const DESCRIPTION_KEY = K.Descriptable.description.key;
+/** Qualified key of the `Statused.status` prop. */
+export const STATUS_KEY = K.Statused.status.key;
+/** Read a string prop by qualified key, or `undefined` when absent/non-string. */
+function stringProp(props, key) {
+    const v = props[key];
+    return typeof v === 'string' && v.length > 0 ? v : undefined;
+}
+/** The last path segment, from either a typed `AbsolutePath` or a raw string. */
+function basenameOf(path) {
+    if (typeof path === 'string') {
+        const trimmed = path.replace(/\/+$/, '');
+        const seg = trimmed.slice(trimmed.lastIndexOf('/') + 1);
+        return seg.length > 0 ? seg : path;
+    }
+    const raw = typeof path.raw === 'string' ? path.raw : '';
+    return path.basename?.() ?? (raw.length > 0 ? raw : '');
+}
+/**
+ * A node's display name: its `Named.name` when set, else the last path segment,
+ * else the raw path. Always a non-empty string for a real node.
+ */
+export function nameOf(node) {
+    return stringProp(node.props, NAME_KEY) ?? basenameOf(node.path);
+}
+/** A node's `Descriptable.description`, or `undefined` when unset. */
+export function descriptionOf(node) {
+    return stringProp(node.props, DESCRIPTION_KEY);
+}
+/** A node's `Statused.status`, or `undefined` when unset. */
+export function statusOf(node) {
+    return stringProp(node.props, STATUS_KEY);
+}
+//# sourceMappingURL=named.js.map

package/dist/graph/named.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"named.js","sourceRoot":"","sources":["../../src/graph/named.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,yBAAyB,CAAA;AAE3C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAA;AAExC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,GAAG,CAAA;AAE7D,mDAAmD;AACnD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAA;AAY/C,kFAAkF;AAClF,SAAS,UAAU,CAAC,KAAiB,EAAE,GAAW;IAChD,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;IACpB,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAC9D,CAAC;AAED,iFAAiF;AACjF,SAAS,UAAU,CAAC,IAA2B;IAC7C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QACxC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;QACvD,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;IACpC,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;IACxD,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,IAAmB;IACxC,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAClE,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,IAAkC;IAC9D,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,CAAA;AAChD,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,QAAQ,CAAC,IAAkC;IACzD,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;AAC3C,CAAC"}