@astrale-os/kernel-client 0.2.4 → 0.3.1

package/dist/auth/principal.js

@@ -0,0 +1,46 @@
+/**
+ * Caller resolution for the auth surface — the live `whoami` verb, the memoized
+ * principal id (one per bound view), and ref→dispatch-address resolution over
+ * the shared {@link GraphCall} capability.
+ */
+import { Graph } from '@astrale-os/kernel-core';
+import { refRaw } from '../graph/mutate';
+import { instanceTarget, WHOAMI_PATH } from './addressing';
+/** Assert the whoami dispatch produced a node record; throw loud otherwise. */
+function asWhoamiWire(raw) {
+    if (raw === null || typeof raw !== 'object' || typeof raw.id !== 'string') {
+        throw new Error('Identity.whoami returned an unexpected shape — expected a node record');
+    }
+    return raw;
+}
+/** Hydrate the single-node whoami wire record into kernel-core's Node value. */
+function adaptWhoami(node) {
+    const graph = Graph.fromWire({ nodes: [node], edges: [] });
+    const found = graph.nodes.byId(node.id);
+    if (found === undefined) {
+        throw new Error('Identity.whoami returned a node that could not be hydrated');
+    }
+    return found;
+}
+/** Bind the caller resolver onto a call capability — one principal memo per view. */
+export function createCaller(call) {
+    // Principal memo — id only, a PROMISE so concurrent first callers dedup to ONE
+    // whoami dispatch. Separate from the public `whoami()`, which is never cached.
+    let principalMemo;
+    const rawWhoami = async () => asWhoamiWire(await call(WHOAMI_PATH, {}));
+    const principal = () => {
+        if (principalMemo === undefined) {
+            principalMemo = rawWhoami().then((node) => node.id, (error) => {
+                principalMemo = undefined; // clear on rejection so the next call retries
+                throw error;
+            });
+        }
+        return principalMemo;
+    };
+    return {
+        whoami: async () => adaptWhoami(await rawWhoami()),
+        principal,
+        targetFor: async (ref, slug) => instanceTarget(ref !== undefined ? refRaw(ref) : await principal(), slug),
+    };
+}
+//# sourceMappingURL=principal.js.map

package/dist/auth/principal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"principal.js","sourceRoot":"","sources":["../../src/auth/principal.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AAI/C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAK1D,+EAA+E;AAC/E,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAQ,GAAwB,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QAChG,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAA;IAC1F,CAAC;IACD,OAAO,GAAiB,CAAA;AAC1B,CAAC;AAED,gFAAgF;AAChF,SAAS,WAAW,CAAC,IAAgB;IACnC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;IAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACvC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAA;IAC/E,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAYD,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAC,IAAe;IAC1C,+EAA+E;IAC/E,+EAA+E;IAC/E,IAAI,aAA0C,CAAA;IAE9C,MAAM,SAAS,GAAG,KAAK,IAAyB,EAAE,CAAC,YAAY,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAA;IAE5F,MAAM,SAAS,GAAG,GAAoB,EAAE;QACtC,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,aAAa,GAAG,SAAS,EAAE,CAAC,IAAI,CAC9B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EACjB,CAAC,KAAc,EAAE,EAAE;gBACjB,aAAa,GAAG,SAAS,CAAA,CAAC,8CAA8C;gBACxE,MAAM,KAAK,CAAA;YACb,CAAC,CACF,CAAA;QACH,CAAC;QACD,OAAO,aAAa,CAAA;IACtB,CAAC,CAAA;IAED,OAAO;QACL,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,MAAM,SAAS,EAAE,CAAC;QAClD,SAAS;QACT,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAC7B,cAAc,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,SAAS,EAAE,EAAE,IAAI,CAAC;KAC5E,CAAA;AACH,CAAC"}

package/dist/errors/errors.d.ts

@@ -66,6 +66,18 @@ export declare class KernelError extends WebOSError {
     readonly data?: unknown;
     constructor(message: string, code: number, type?: string, data?: unknown);
 }
+/** The wire payload could not be decoded into a request envelope. */
+export declare class ParseError extends KernelError {
+    constructor(message?: string, data?: unknown);
+}
+/** The decoded request envelope failed protocol validation. */
+export declare class InvalidRequestError extends KernelError {
+    constructor(message?: string, data?: unknown);
+}
+/** The kernel returned an internal failure payload. */
+export declare class InternalKernelError extends KernelError {
+    constructor(message?: string, data?: unknown);
+}
 /**
  * Validation error. `errors` holds the server-reported `FieldError[]`,
  * orthogonal to the inherited `WebOSError.details` (which carries
@@ -87,6 +99,47 @@ export declare class InvariantViolationError extends KernelError {
 export declare class NotFoundError extends WebOSError {
     constructor(message?: string);
 }
+/**
+ * A `get()` / `getOrThrow()` read resolved to no visible node at the address.
+ * DELIBERATELY opaque: it does NOT distinguish "does not exist" from "exists but
+ * not READable by the caller" — the kernel folds both to an empty read so
+ * neither can be probed. `context` prefixes the message with the caller's intent.
+ */
+export declare class NodeUnavailableError extends WebOSError {
+    readonly path: string;
+    constructor(path: string, context?: string);
+}
+/**
+ * One entry's fate in a batched auth operation. `input` summarizes the entry so
+ * a caller can tell WHICH one it is. `value` is present only when fulfilled (so
+ * a partial-failure catcher can recover successes); `error` only when rejected.
+ */
+export type AuthBatchOutcome = {
+    index: number;
+    /** Perm verbs: the caller's entry; bind/unbind: a `{ who, edge, counterparty }` dispatch summary. */
+    input: unknown;
+    status: 'fulfilled' | 'rejected';
+    value?: unknown;
+    error?: unknown;
+};
+/**
+ * A batched auth call had at least one entry fail. Set semantics, not a
+ * transaction: partial application is possible, so this carries EVERY entry's
+ * outcome — inspect {@link outcomes} (or {@link failures}) to see which landed.
+ */
+export declare class AuthBatchError extends WebOSError {
+    /** The verb that fanned out — `'check' | 'grant' | 'revoke' | 'bind' | 'unbind'`. */
+    readonly operation: string;
+    /** Positionally-aligned outcome per dispatched entry. */
+    readonly outcomes: readonly AuthBatchOutcome[];
+    constructor(
+    /** The verb that fanned out — `'check' | 'grant' | 'revoke' | 'bind' | 'unbind'`. */
+    operation: string, 
+    /** Positionally-aligned outcome per dispatched entry. */
+    outcomes: readonly AuthBatchOutcome[]);
+    /** The rejected entries only — the subset a caller must react to. */
+    get failures(): readonly AuthBatchOutcome[];
+}
 /**
  * Map a `{ code, message, data }` envelope error to a typed `WebOSError`.
  * The caller is responsible for attaching `ClientErrorDetails` via

package/dist/errors/errors.d.ts.map

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

package/dist/errors/errors.js

@@ -79,6 +79,27 @@ export class KernelError extends WebOSError {
         this.name = 'KernelError';
     }
 }
+/** The wire payload could not be decoded into a request envelope. */
+export class ParseError extends KernelError {
+    constructor(message = 'Parse error', data) {
+        super(message, KERNEL_ERROR_CODES.PARSE_ERROR, 'PARSE_ERROR', data);
+        this.name = 'ParseError';
+    }
+}
+/** The decoded request envelope failed protocol validation. */
+export class InvalidRequestError extends KernelError {
+    constructor(message = 'Invalid request', data) {
+        super(message, KERNEL_ERROR_CODES.INVALID_REQUEST, 'INVALID_REQUEST', data);
+        this.name = 'InvalidRequestError';
+    }
+}
+/** The kernel returned an internal failure payload. */
+export class InternalKernelError extends KernelError {
+    constructor(message = 'Internal kernel error', data) {
+        super(message, KERNEL_ERROR_CODES.INTERNAL_ERROR, 'INTERNAL_ERROR', data);
+        this.name = 'InternalKernelError';
+    }
+}
 /**
  * Validation error. `errors` holds the server-reported `FieldError[]`,
  * orthogonal to the inherited `WebOSError.details` (which carries
@@ -119,6 +140,46 @@ export class NotFoundError extends WebOSError {
         this.name = 'NotFoundError';
     }
 }
+/**
+ * A `get()` / `getOrThrow()` read resolved to no visible node at the address.
+ * DELIBERATELY opaque: it does NOT distinguish "does not exist" from "exists but
+ * not READable by the caller" — the kernel folds both to an empty read so
+ * neither can be probed. `context` prefixes the message with the caller's intent.
+ */
+export class NodeUnavailableError extends WebOSError {
+    path;
+    constructor(path, context) {
+        super(context
+            ? `${context}: node "${path}" not found or not visible`
+            : `node "${path}" not found or not visible`);
+        this.path = path;
+        this.name = 'NodeUnavailableError';
+    }
+}
+/**
+ * A batched auth call had at least one entry fail. Set semantics, not a
+ * transaction: partial application is possible, so this carries EVERY entry's
+ * outcome — inspect {@link outcomes} (or {@link failures}) to see which landed.
+ */
+export class AuthBatchError extends WebOSError {
+    operation;
+    outcomes;
+    constructor(
+    /** The verb that fanned out — `'check' | 'grant' | 'revoke' | 'bind' | 'unbind'`. */
+    operation, 
+    /** Positionally-aligned outcome per dispatched entry. */
+    outcomes) {
+        const failures = outcomes.filter((o) => o.status === 'rejected');
+        super(`auth.${operation}: ${failures.length} of ${outcomes.length} entries failed`);
+        this.operation = operation;
+        this.outcomes = outcomes;
+        this.name = 'AuthBatchError';
+    }
+    /** The rejected entries only — the subset a caller must react to. */
+    get failures() {
+        return this.outcomes.filter((o) => o.status === 'rejected');
+    }
+}
 // ─── Error mapping ──────────────────────────────────────
 const AUTH_REASON_BY_CODE = {
     [KERNEL_ERROR_CODES.AUTH_MISSING]: 'missing',
@@ -131,6 +192,10 @@ const AUTH_REASON_BY_CODE = {
  * `withDetails` after mapping.
  */
 export function mapServerError(code, message, data) {
+    if (code === KERNEL_ERROR_CODES.PARSE_ERROR)
+        return new ParseError(message, data);
+    if (code === KERNEL_ERROR_CODES.INVALID_REQUEST)
+        return new InvalidRequestError(message, data);
     const authReason = AUTH_REASON_BY_CODE[code];
     if (authReason)
         return new AuthenticationError(message, authReason);
@@ -145,13 +210,16 @@ export function mapServerError(code, message, data) {
     if (code === KERNEL_ERROR_CODES.INVARIANT_VIOLATION) {
         return new InvariantViolationError(message, readErrors(data));
     }
+    if (code === KERNEL_ERROR_CODES.INTERNAL_ERROR)
+        return new InternalKernelError(message, data);
     return new KernelError(message, code, 'KERNEL_ERROR', data);
 }
 function readErrors(data) {
     if (Array.isArray(data))
         return data;
     if (data && typeof data === 'object') {
-        const errs = data.errors;
+        const record = data;
+        const errs = record.errors ?? record.details;
         if (Array.isArray(errs))
             return errs;
     }

package/dist/errors/errors.js.map

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

package/dist/errors/guards.d.ts

@@ -0,0 +1,39 @@
+import type { PoolClosedError } from '../pool/errors';
+import type { DelegationMintError, DelegationPolicyError, DelegationRefusedError } from '../session/delegation/errors';
+import type { IdentityPickerError, PersistenceLoadFailedError, RegistryWriteFailedError, SchemaOwnershipConflictError, UnresolvedIdentityError } from '../session/errors/session-errors';
+import type { HopLimitExceededError, RedirectPolicyError, RedirectRefusedError } from '../session/redirect/errors';
+import type { ClientSessionError } from './session-error';
+import { AuthBatchError, AuthenticationError, ConnectionError, DisconnectedError, InternalKernelError, InvalidRequestError, InvalidTransportError, InvariantViolationError, KernelError, NodeUnavailableError, NotFoundError, ParseError, PermissionDeniedError, TimeoutError, UnsupportedTransportError, ValidationError, WebOSError } from './errors';
+export type TransportError = ConnectionError | DisconnectedError | TimeoutError;
+export type IdentityError = UnresolvedIdentityError | IdentityPickerError;
+export type KernelErrorKind = 'authentication' | 'permission-denied' | 'not-found' | 'validation' | 'invariant-violation' | 'parse-error' | 'invalid-request' | 'internal' | 'node-unavailable' | 'auth-batch' | 'redirect-refused' | 'redirect-policy' | 'hop-limit' | 'delegation-refused' | 'delegation-mint' | 'delegation-policy' | 'identity' | 'registry-write' | 'schema-ownership' | 'persistence-load' | 'pool-closed' | 'transport' | 'invalid-transport' | 'unsupported-transport' | 'kernel' | 'client-session' | 'client' | 'unknown';
+export declare function isPermissionDeniedError(e: unknown): e is PermissionDeniedError;
+export declare function isNotFoundError(e: unknown): e is NotFoundError;
+export declare function isValidationError(e: unknown): e is ValidationError;
+export declare function isAuthenticationError(e: unknown): e is AuthenticationError;
+export declare function isRedirectRefusedError(e: unknown): e is RedirectRefusedError;
+export declare function isTransportError(e: unknown): e is TransportError;
+export declare function isInvariantViolationError(e: unknown): e is InvariantViolationError;
+export declare function isParseError(e: unknown): e is ParseError;
+export declare function isInvalidRequestError(e: unknown): e is InvalidRequestError;
+export declare function isInternalKernelError(e: unknown): e is InternalKernelError;
+export declare function isNodeUnavailableError(e: unknown): e is NodeUnavailableError;
+export declare function isAuthBatchError(e: unknown): e is AuthBatchError;
+export declare function isRedirectPolicyError(e: unknown): e is RedirectPolicyError;
+export declare function isHopLimitExceededError(e: unknown): e is HopLimitExceededError;
+export declare function isDelegationRefusedError(e: unknown): e is DelegationRefusedError;
+export declare function isDelegationMintError(e: unknown): e is DelegationMintError;
+export declare function isDelegationPolicyError(e: unknown): e is DelegationPolicyError;
+export declare function isIdentityError(e: unknown): e is IdentityError;
+export declare function isRegistryWriteFailedError(e: unknown): e is RegistryWriteFailedError;
+export declare function isSchemaOwnershipConflictError(e: unknown): e is SchemaOwnershipConflictError;
+export declare function isPersistenceLoadFailedError(e: unknown): e is PersistenceLoadFailedError;
+export declare function isPoolClosedError(e: unknown): e is PoolClosedError;
+export declare function isInvalidTransportError(e: unknown): e is InvalidTransportError;
+export declare function isUnsupportedTransportError(e: unknown): e is UnsupportedTransportError;
+export declare function isKernelError(e: unknown): e is KernelError;
+export declare function isClientSessionError(e: unknown): e is ClientSessionError;
+export declare function isWebOSError(e: unknown): e is WebOSError;
+/** Classify an unknown thrown value for UI affordance selection. */
+export declare function classifyKernelError(e: unknown): KernelErrorKind;
+//# sourceMappingURL=guards.d.ts.map

package/dist/errors/guards.d.ts.map

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

package/dist/errors/guards.js

@@ -0,0 +1,127 @@
+import { AuthBatchError, AuthenticationError, ConnectionError, DisconnectedError, InternalKernelError, InvalidRequestError, InvalidTransportError, InvariantViolationError, KernelError, NodeUnavailableError, NotFoundError, ParseError, PermissionDeniedError, TimeoutError, UnsupportedTransportError, ValidationError, WebOSError, } from './errors';
+export function isPermissionDeniedError(e) {
+    return e instanceof PermissionDeniedError;
+}
+export function isNotFoundError(e) {
+    return e instanceof NotFoundError;
+}
+export function isValidationError(e) {
+    return e instanceof ValidationError;
+}
+export function isAuthenticationError(e) {
+    return e instanceof AuthenticationError;
+}
+export function isRedirectRefusedError(e) {
+    return hasNameAndKind(e, 'RedirectRefusedError', 'REDIRECT_REFUSED');
+}
+export function isTransportError(e) {
+    return e instanceof ConnectionError || e instanceof DisconnectedError || e instanceof TimeoutError;
+}
+export function isInvariantViolationError(e) {
+    return e instanceof InvariantViolationError;
+}
+export function isParseError(e) {
+    return e instanceof ParseError;
+}
+export function isInvalidRequestError(e) {
+    return e instanceof InvalidRequestError;
+}
+export function isInternalKernelError(e) {
+    return e instanceof InternalKernelError;
+}
+export function isNodeUnavailableError(e) {
+    return e instanceof NodeUnavailableError;
+}
+export function isAuthBatchError(e) {
+    return e instanceof AuthBatchError;
+}
+export function isRedirectPolicyError(e) {
+    return hasNameAndKind(e, 'RedirectPolicyError', 'REDIRECT_POLICY_THREW');
+}
+export function isHopLimitExceededError(e) {
+    return hasNameAndKind(e, 'HopLimitExceededError', 'HOP_LIMIT_EXCEEDED');
+}
+export function isDelegationRefusedError(e) {
+    return hasNameAndKind(e, 'DelegationRefusedError', 'DELEGATION_REFUSED');
+}
+export function isDelegationMintError(e) {
+    return hasNameAndKind(e, 'DelegationMintError', 'DELEGATION_MINT_FAILED');
+}
+export function isDelegationPolicyError(e) {
+    return hasNameAndKind(e, 'DelegationPolicyError', 'DELEGATION_POLICY_THREW');
+}
+export function isIdentityError(e) {
+    return (hasNameAndKind(e, 'UnresolvedIdentityError', 'IDENTITY_UNRESOLVED') ||
+        hasNameAndKind(e, 'IdentityPickerError', 'IDENTITY_PICKER_THREW'));
+}
+export function isRegistryWriteFailedError(e) {
+    return hasNameAndKind(e, 'RegistryWriteFailedError', 'REGISTRY_WRITE_FAILED');
+}
+export function isSchemaOwnershipConflictError(e) {
+    return hasNameAndKind(e, 'SchemaOwnershipConflictError', 'SCHEMA_OWNERSHIP_CONFLICT');
+}
+export function isPersistenceLoadFailedError(e) {
+    return hasNameAndKind(e, 'PersistenceLoadFailedError', 'PERSISTENCE_LOAD_FAILED');
+}
+export function isPoolClosedError(e) {
+    return hasNameAndKind(e, 'PoolClosedError', 'POOL_CLOSED');
+}
+export function isInvalidTransportError(e) {
+    return e instanceof InvalidTransportError;
+}
+export function isUnsupportedTransportError(e) {
+    return e instanceof UnsupportedTransportError;
+}
+export function isKernelError(e) {
+    return e instanceof KernelError;
+}
+export function isClientSessionError(e) {
+    return e instanceof WebOSError && !isPoolClosedError(e) && typeof getKind(e) === 'string';
+}
+export function isWebOSError(e) {
+    return e instanceof WebOSError;
+}
+const KERNEL_ERROR_CLASSIFIERS = [
+    ['authentication', isAuthenticationError],
+    ['permission-denied', isPermissionDeniedError],
+    ['not-found', isNotFoundError],
+    ['validation', isValidationError],
+    ['invariant-violation', isInvariantViolationError],
+    ['parse-error', isParseError],
+    ['invalid-request', isInvalidRequestError],
+    ['internal', isInternalKernelError],
+    ['node-unavailable', isNodeUnavailableError],
+    ['auth-batch', isAuthBatchError],
+    ['redirect-refused', isRedirectRefusedError],
+    ['redirect-policy', isRedirectPolicyError],
+    ['hop-limit', isHopLimitExceededError],
+    ['delegation-refused', isDelegationRefusedError],
+    ['delegation-mint', isDelegationMintError],
+    ['delegation-policy', isDelegationPolicyError],
+    ['identity', isIdentityError],
+    ['registry-write', isRegistryWriteFailedError],
+    ['schema-ownership', isSchemaOwnershipConflictError],
+    ['persistence-load', isPersistenceLoadFailedError],
+    ['pool-closed', isPoolClosedError],
+    ['transport', isTransportError],
+    ['invalid-transport', isInvalidTransportError],
+    ['unsupported-transport', isUnsupportedTransportError],
+    ['kernel', isKernelError],
+    ['client-session', isClientSessionError],
+    ['client', isWebOSError],
+];
+/** Classify an unknown thrown value for UI affordance selection. */
+export function classifyKernelError(e) {
+    for (const [kind, guard] of KERNEL_ERROR_CLASSIFIERS) {
+        if (guard(e))
+            return kind;
+    }
+    return 'unknown';
+}
+function hasNameAndKind(e, name, kind) {
+    return e instanceof Error && e.name === name && getKind(e) === kind;
+}
+function getKind(e) {
+    return e !== null && typeof e === 'object' ? e.kind : undefined;
+}
+//# sourceMappingURL=guards.js.map

package/dist/errors/guards.js.map

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

package/dist/errors/index.d.ts

@@ -1,4 +1,6 @@
-export { AuthenticationError, ConnectionError, DisconnectedError, InvalidTransportError, InvariantViolationError, KernelError, NotFoundError, PermissionDeniedError, TimeoutError, UnsupportedTransportError, ValidationError, WebOSError, mapServerError, withDetails, } from './errors';
-export type { AuthReason, ClientErrorDetails } from './errors';
+export { AuthBatchError, AuthenticationError, ConnectionError, DisconnectedError, InternalKernelError, InvalidTransportError, InvalidRequestError, InvariantViolationError, KernelError, NodeUnavailableError, NotFoundError, ParseError, PermissionDeniedError, TimeoutError, UnsupportedTransportError, ValidationError, WebOSError, mapServerError, withDetails, } from './errors';
+export type { AuthBatchOutcome, AuthReason, ClientErrorDetails } from './errors';
+export { classifyKernelError, isAuthBatchError, isAuthenticationError, isClientSessionError, isDelegationMintError, isDelegationPolicyError, isDelegationRefusedError, isHopLimitExceededError, isIdentityError, isInternalKernelError, isInvalidRequestError, isInvalidTransportError, isInvariantViolationError, isKernelError, isNodeUnavailableError, isNotFoundError, isParseError, isPermissionDeniedError, isPersistenceLoadFailedError, isPoolClosedError, isRedirectPolicyError, isRedirectRefusedError, isRegistryWriteFailedError, isSchemaOwnershipConflictError, isTransportError, isUnsupportedTransportError, isValidationError, isWebOSError, } from './guards';
+export type { IdentityError, KernelErrorKind, TransportError } from './guards';
 export { ClientSessionError } from './session-error';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,yBAAyB,EACzB,eAAe,EACf,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,YAAY,EACZ,yBAAyB,EACzB,eAAe,EACf,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAChF,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,YAAY,EACZ,uBAAuB,EACvB,4BAA4B,EAC5B,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,8BAA8B,EAC9B,gBAAgB,EAChB,2BAA2B,EAC3B,iBAAiB,EACjB,YAAY,GACb,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/errors/index.js

@@ -1,3 +1,4 @@
-export { AuthenticationError, ConnectionError, DisconnectedError, InvalidTransportError, InvariantViolationError, KernelError, NotFoundError, PermissionDeniedError, TimeoutError, UnsupportedTransportError, ValidationError, WebOSError, mapServerError, withDetails, } from './errors';
+export { AuthBatchError, AuthenticationError, ConnectionError, DisconnectedError, InternalKernelError, InvalidTransportError, InvalidRequestError, InvariantViolationError, KernelError, NodeUnavailableError, NotFoundError, ParseError, PermissionDeniedError, TimeoutError, UnsupportedTransportError, ValidationError, WebOSError, mapServerError, withDetails, } from './errors';
+export { classifyKernelError, isAuthBatchError, isAuthenticationError, isClientSessionError, isDelegationMintError, isDelegationPolicyError, isDelegationRefusedError, isHopLimitExceededError, isIdentityError, isInternalKernelError, isInvalidRequestError, isInvalidTransportError, isInvariantViolationError, isKernelError, isNodeUnavailableError, isNotFoundError, isParseError, isPermissionDeniedError, isPersistenceLoadFailedError, isPoolClosedError, isRedirectPolicyError, isRedirectRefusedError, isRegistryWriteFailedError, isSchemaOwnershipConflictError, isTransportError, isUnsupportedTransportError, isValidationError, isWebOSError, } from './guards';
 export { ClientSessionError } from './session-error';
 //# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,yBAAyB,EACzB,eAAe,EACf,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,YAAY,EACZ,yBAAyB,EACzB,eAAe,EACf,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,YAAY,EACZ,uBAAuB,EACvB,4BAA4B,EAC5B,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,8BAA8B,EAC9B,gBAAgB,EAChB,2BAA2B,EAC3B,iBAAiB,EACjB,YAAY,GACb,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/graph/api.d.ts

@@ -0,0 +1,82 @@
+/**
+ * The `GraphApi` surface and its one implementation, `createGraph` — graph
+ * sugar over the two batch syscalls (`function.get` / `function.mutate`),
+ * pure over a {@link GraphCall} capability. Bound per context: the shell
+ * exposes it as `shell.kernel.graph`, the SDK as `ctx.graph`, and a client
+ * session flattens it directly onto the view (`session.as(cred).get`, `.query`,
+ * `.mutate`, …).
+ */
+import type { QueryASTInput } from '@astrale-os/kernel-core';
+import type { PatchBuilder, PatchInput, WriteShorthands } from './mutate';
+import type { GatherBuilder, QuerySource, ReadShorthands } from './query';
+import type { GraphResult } from './result';
+import type { MutationResultWire } from './wire';
+/** Colon FunctionPath of the `function.get` read syscall. */
+export declare const KERNEL_GET_PATH: string;
+/** Colon FunctionPath of the `function.mutate` write syscall. */
+export declare const KERNEL_MUTATE_PATH: string;
+/**
+ * Graph sugar over the two batch syscalls (`function.get`/`function.mutate`).
+ *
+ * Two operations: `query` (structured read) and `mutate` (batch write), plus
+ * the read/write shorthand families.
+ *
+ * READS are 0..N: a read whose roots all fail to resolve folds to an EMPTY
+ * envelope, never a NOT_FOUND throw (at this surface missing ≡ masked). WRITES
+ * return their outcome directly (a minted id, or nothing). Methods otherwise
+ * throw whatever the bound call throws (`PermissionDeniedError`,
+ * `ValidationError`, …), plus `UnsupportedQueryError` / `InvalidQueryError`
+ * from `query` lowering.
+ */
+export interface GraphApi extends ReadShorthands, WriteShorthands {
+    /** Structured read — builder callback or AST value. See {@link QueryFn}. */
+    query: QueryFn;
+    /** Batch write — `function.mutate`, all-or-nothing. See {@link MutateFn}. */
+    mutate: MutateFn;
+}
+/**
+ * The write operation `mutate`, two shapes under one name:
+ *
+ *   mutate((m) => { m.createNode(...); m.link(...) })   // fluent builder
+ *   mutate(patch)                                        // pre-built patch value
+ *
+ * The builder callback (sync or async) accumulates any mix of node/edge ops,
+ * committed as ONE atomic `function.mutate` when it returns; a throw inside it
+ * writes nothing. Atomicity covers only the single final write.
+ */
+export interface MutateFn {
+    (build: (m: PatchBuilder) => void | Promise<void>): Promise<MutationResultWire>;
+    (patch: PatchInput): Promise<MutationResultWire>;
+}
+/**
+ * The read operation `query`, two shapes under one name — the structural
+ * sibling of {@link MutateFn}:
+ *
+ *   query((q) => q.from(folder).children().out('author'))   // fluent builder
+ *   query(ast)                                               // pre-built AST value
+ *
+ * Either shape lowers to `function.get`; a capability beyond it throws
+ * `UnsupportedQueryError` naming the gap — never a degraded result.
+ */
+export interface QueryFn {
+    (build: (q: QuerySource) => GatherBuilder): Promise<GraphResult>;
+    (ast: QueryASTInput): Promise<GraphResult>;
+}
+/**
+ * The one capability the graph sugar needs: a plain-value kernel call. Bind it
+ * to whatever dispatch surface the host context has — `ClientSession.call`,
+ * the shell's `kernel.call`, or the SDK handler's `ctx.kernel.call`.
+ */
+export type GraphCall = (method: string, params: unknown) => Promise<unknown>;
+/** Bind the graph sugar onto a call capability. */
+export declare function createGraph(call: GraphCall, opts?: CreateGraphOpts): GraphApi;
+export type CreateGraphOpts = {
+    /**
+     * Classify an error thrown by the bound call as the kernel's not-found
+     * outcome. Defaults to `instanceof NotFoundError` — correct for every
+     * binding that routes through this package's error mapping. Inject only for
+     * exotic bindings (in-process test doubles) that bypass `mapServerError`.
+     */
+    isNotFound?: (error: unknown) => boolean;
+};
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/graph/api.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAY,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAItE,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,KAAK,EAAiB,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAU/D,6DAA6D;AAC7D,eAAO,MAAM,eAAe,QAA+B,CAAA;AAC3D,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,QAAkC,CAAA;AAEjE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,QAAS,SAAQ,cAAc,EAAE,eAAe;IAC/D,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAA;IACd,6EAA6E;IAC7E,MAAM,EAAE,QAAQ,CAAA;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC/E,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;CACjD;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,OAAO;IACtB,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAChE,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CAC3C;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAE7E,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,QAAQ,CAuD7E;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;CACzC,CAAA"}

package/dist/graph/api.js

@@ -0,0 +1,64 @@
+/**
+ * The `GraphApi` surface and its one implementation, `createGraph` — graph
+ * sugar over the two batch syscalls (`function.get` / `function.mutate`),
+ * pure over a {@link GraphCall} capability. Bound per context: the shell
+ * exposes it as `shell.kernel.graph`, the SDK as `ctx.graph`, and a client
+ * session flattens it directly onto the view (`session.as(cred).get`, `.query`,
+ * `.mutate`, …).
+ */
+import { K, queryAstSchema } from '@astrale-os/kernel-core';
+import { NotFoundError } from '../errors/errors';
+import { makeWriteShorthands, PatchBuilderImpl } from './mutate';
+import { lowerToGet, makeReadShorthands, Q } from './query';
+import { makeGraphResult } from './result';
+// Call addresses straight from the compiled kernel schema — the one canonical
+// accessor, no constant mirrors. Exported as the schema-derived syscall paths
+// so callers dispatching raw (`session.call`) share the exact address.
+/** Colon FunctionPath of the `function.get` read syscall. */
+export const KERNEL_GET_PATH = K.$.f('get').path.domain.raw;
+/** Colon FunctionPath of the `function.mutate` write syscall. */
+export const KERNEL_MUTATE_PATH = K.$.f('mutate').path.domain.raw;
+/** Bind the graph sugar onto a call capability. */
+export function createGraph(call, opts) {
+    const isNotFound = opts?.isNotFound ?? ((error) => error instanceof NotFoundError);
+    const rawGet = (input) => call(KERNEL_GET_PATH, input);
+    const commit = (patch) => call(KERNEL_MUTATE_PATH, patch);
+    // function.get throws NOT_FOUND when no root resolves; at this surface that is
+    // an EMPTY result (0..N cardinality, missing ≡ masked). Transport and
+    // permission errors still propagate. Shared by `query` and the read shorthands.
+    const read = async (input) => {
+        try {
+            return await rawGet(input);
+        }
+        catch (error) {
+            if (!isNotFound(error))
+                throw error;
+            return { nodes: [], edges: [], roots: [] };
+        }
+    };
+    // Assemble via the builder, commit as ONE atomic function.mutate, then
+    // back-fill minted ids into the returned NodeRefs.
+    async function commitBuilt(build) {
+        const builder = new PatchBuilderImpl();
+        await build(builder);
+        const result = await commit(builder.build());
+        builder.resolve(result.createdNodes);
+        return result;
+    }
+    const mutate = ((arg) => typeof arg === 'function' ? commitBuilt(arg) : commit(arg));
+    const runGet = (ast) => read(lowerToGet(ast));
+    const runQuery = async (ast) => makeGraphResult(runGet, ast, await runGet(ast));
+    const runParsedQuery = async (ast) => {
+        const input = ast.version === undefined ? { ...ast, version: 1 } : ast;
+        const parsed = queryAstSchema.parse(input);
+        return makeGraphResult(runGet, parsed, await runGet(parsed));
+    };
+    const query = ((arg) => typeof arg === 'function' ? runQuery(arg(Q).toAST()) : runParsedQuery(arg));
+    return {
+        query,
+        mutate,
+        ...makeReadShorthands(runGet),
+        ...makeWriteShorthands(commit),
+    };
+}
+//# sourceMappingURL=api.js.map