@neuralis/brain-core 0.3.2 → 0.4.0

package/dist/scripts/sourceToHostV1.js.map

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

package/dist/src/connectors/AppSourceConfigStore.d.ts

@@ -22,19 +22,27 @@ import { type Logger } from '@neuralis/package-system/data';
 import type { SourceConfigPort, SourceConfigScope, ScopedSourceConfig } from './types.js';
 import type { SourceConfig } from '../domain/sourceConfig.js';
 import { type PackageSourceRoot } from '../services/declaredSources.js';
+import { type SourceRootPlane } from '../domain/sourceRootPair.js';
 /**
  * Convert a source string to a safe filename slug.
  * "data" → "data", "github:neuralis/Neuralis" → "github-neuralis-Neuralis"
  */
 declare function sourceSlug(source: string): string;
 export declare const SOURCE_CONFIG_FORMAT_KIND: "brain-core/source-config";
-export declare const SOURCE_CONFIG_FORMAT_VERSION: 2;
+export declare const SOURCE_CONFIG_FORMAT_VERSION: 7;
 export declare class AppSourceConfigStore implements SourceConfigPort {
     #private;
     readonly mutations: SourceConfigMutation;
     private readonly baseDir;
+    /**
+     * `rootPlane` — the runtime stack's plane facts, read at write time. With it
+     * every `upsert` FILLS a missing half of a `local` source's root pair
+     * (`fillSourceRootPair`); without it (or before the facts exist) a write
+     * stores the config as given. Never overwrites a stored half, never refuses.
+     */
     constructor(appRoot: string, opts?: {
         logger?: Logger;
+        rootPlane?: () => SourceRootPlane | null;
     });
     get(scope: SourceConfigScope, source: string): Promise<SourceConfig | null>;
     list(scope: SourceConfigScope): Promise<SourceConfig[]>;
@@ -49,9 +57,15 @@ export declare class AppSourceConfigStore implements SourceConfigPort {
     /**
      * The project's package-source roots off the STRICT persisted listing — for
      * the offline upgrade, which has no runtime and must not read a partial
-     * inventory. The projection is the one `listPackageSourceRoots` uses.
+     * inventory. Its one consumer (`package-identity-v2`) runs on records as they
+     * stood BEFORE the folder kinds were merged — or, on a resumed chain, after
+     * `source-to-folder-v1` or `source-to-host-v1` — so the stored shape is read
+     * as any of them: an in-process folder is `local`, a device-less `folder` or
+     * a device-less `host`, and its package folders are `packageFolders` or the
+     * whole source when `recognizesPackages` was set. The runtime listing reads
+     * v5 only.
      */
-    listPackageSourceRoots(projectId: string, projectRoot: string): Promise<PackageSourceRoot[]>;
+    listPackageSourceRoots(projectId: string, projectRoot: string, isDocker: boolean): Promise<PackageSourceRoot[]>;
     upsert(scope: SourceConfigScope, config: SourceConfig): Promise<SourceConfig>;
     delete(scope: SourceConfigScope, source: string): Promise<boolean>;
     seed(scope: SourceConfigScope, config: SourceConfig): Promise<void>;

package/dist/src/connectors/AppSourceConfigStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppSourceConfigStore.d.ts","sourceRoot":"","sources":["../../../src/connectors/AppSourceConfigStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAA2B,KAAK,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAG/F,OAAO,EAIL,KAAK,MAAM,EACZ,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAE7F;;;GAGG;AACH,iBAAS,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AACnE,eAAO,MAAM,4BAA4B,GAA+B,CAAC;AAEzE,qBAAa,oBAAqB,YAAW,gBAAgB;;IAC3D,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAGjC,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,EAI1D;IAWK,GAAG,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAqBhF;IAEK,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAE5D;IAED;;;OAGG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAsC/F;IAEK,OAAO,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAgB7C;IAED;;;;OAIG;IACG,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAEjG;IAMK,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBlF;IAEK,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMvE;IAEK,IAAI,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CASxE;CAuBF;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"AppSourceConfigStore.d.ts","sourceRoot":"","sources":["../../../src/connectors/AppSourceConfigStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAA2B,KAAK,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAG/F,OAAO,EAIL,KAAK,MAAM,EACZ,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAC7F,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAWvF;;;GAGG;AACH,iBAAS,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AACnE,eAAO,MAAM,4BAA4B,GAA+B,CAAC;AAEzE,qBAAa,oBAAqB,YAAW,gBAAgB;;IAC3D,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAIjC;;;;;OAKG;IACH,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,eAAe,GAAG,IAAI,CAAA;KAAO,EAKpG;IAWK,GAAG,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAqBhF;IAEK,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAE5D;IAED;;;OAGG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAE/F;IAkDK,OAAO,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAgB7C;IAED;;;;;;;;;;OAUG;IACG,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAUpH;IAMK,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAsBlF;IAEK,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMvE;IAEK,IAAI,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CASxE;CAuBF;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/src/connectors/AppSourceConfigStore.js

@@ -25,6 +25,15 @@ import { SOURCE_CONFIG_FORMAT } from '../store/dataFormats.js';
 import { validateSourceConfig } from '../domain/sourceConfig.js';
 import { normalizeSource } from '../domain/source.js';
 import { toPackageSourceRoot } from '../services/declaredSources.js';
+import { fillSourceRootPair } from '../domain/sourceRootPair.js';
+import { HOST_SOURCE_KIND } from '@neuralis/package-system/contracts';
+/**
+ * The folder kind as records spelled it before `source-to-host-v1`: `local`
+ * (in process, v1–v3) and `folder` (either transport, v4). Pinned, offline
+ * reads only — a v3 device record (`host`) never reaches this projection
+ * unconverted, because `source-device-v1` and `source-to-folder-v1` run first.
+ */
+const PRE_HOST_KINDS = new Set(['local', 'folder']);
 /**
  * Convert a source string to a safe filename slug.
  * "data" → "data", "github:neuralis/Neuralis" → "github-neuralis-Neuralis"
@@ -38,10 +47,18 @@ export class AppSourceConfigStore {
     mutations;
     baseDir;
     #logger;
+    #rootPlane;
+    /**
+     * `rootPlane` — the runtime stack's plane facts, read at write time. With it
+     * every `upsert` FILLS a missing half of a `local` source's root pair
+     * (`fillSourceRootPair`); without it (or before the facts exist) a write
+     * stores the config as given. Never overwrites a stored half, never refuses.
+     */
     constructor(appRoot, opts = {}) {
         this.mutations = sourceConfigMutationFor(path.resolve(appRoot));
         this.baseDir = path.join(appRoot, 'config', 'sources');
         this.#logger = opts.logger ?? noopLogger;
+        this.#rootPlane = opts.rootPlane;
     }
     /** A persisted config that failed to load — named once per read, never a path or a value. */
     #warnInvalid(projectId, entry, reason) {
@@ -80,6 +97,13 @@ export class AppSourceConfigStore {
      * Used by connector wiring during bootstrap when no user session exists.
      */
     async listByProject(projectId, opts = {}) {
+        return (await this.#list(projectId, opts)).map(({ config }) => config);
+    }
+    /**
+     * The listing behind `listByProject`. `readAs` (the offline projection only)
+     * re-spells a record BEFORE validation and keeps the stored kind beside it.
+     */
+    async #list(projectId, opts) {
         const dir = this.#projectDir(projectId);
         let listed = false;
         try {
@@ -101,10 +125,11 @@ export class AppSourceConfigStore {
                             throw new Error('Source inventory contains a non-regular config');
                     }
                     const raw = await fs.readFile(path.join(dir, entry), 'utf-8');
-                    const parsed = JSON.parse(raw);
+                    const stored = JSON.parse(raw);
+                    const parsed = opts.readAs ? opts.readAs(stored) : stored;
                     const validation = validateSourceConfig(parsed);
                     if (validation.ok)
-                        configs.push(parsed);
+                        configs.push({ config: parsed, storedKind: String(stored.connection?.kind ?? '') });
                     else {
                         if (opts.strict)
                             throw new Error('Source inventory contains an invalid config');
@@ -150,17 +175,32 @@ export class AppSourceConfigStore {
     /**
      * The project's package-source roots off the STRICT persisted listing — for
      * the offline upgrade, which has no runtime and must not read a partial
-     * inventory. The projection is the one `listPackageSourceRoots` uses.
+     * inventory. Its one consumer (`package-identity-v2`) runs on records as they
+     * stood BEFORE the folder kinds were merged — or, on a resumed chain, after
+     * `source-to-folder-v1` or `source-to-host-v1` — so the stored shape is read
+     * as any of them: an in-process folder is `local`, a device-less `folder` or
+     * a device-less `host`, and its package folders are `packageFolders` or the
+     * whole source when `recognizesPackages` was set. The runtime listing reads
+     * v5 only.
      */
-    async listPackageSourceRoots(projectId, projectRoot) {
-        return (await this.listByProject(projectId, { strict: true })).map((config) => toPackageSourceRoot(config, projectRoot));
+    async listPackageSourceRoots(projectId, projectRoot, isDocker) {
+        const readAs = (record) => PRE_HOST_KINDS.has(record.connection?.kind)
+            ? { ...record, connection: { ...record.connection, kind: HOST_SOURCE_KIND } }
+            : record;
+        return (await this.#list(projectId, { strict: true, readAs })).map(({ config, storedKind }) => {
+            const stored = config;
+            const packageFolders = stored.recognizesPackages === true ? [''] : (stored.packageFolders ?? []);
+            return { ...toPackageSourceRoot(stored, projectRoot, isDocker), packageFolders: [...packageFolders], kind: storedKind };
+        });
     }
     // ---------------------------------------------------------------------------
     // Write
     // ---------------------------------------------------------------------------
     async upsert(scope, config) {
+        const plane = this.#rootPlane?.() ?? null;
+        const cloned = structuredClone(config);
         const normalized = {
-            ...structuredClone(config),
+            ...(plane ? fillSourceRootPair(cloned, plane) : cloned),
             source: normalizeSource(config.source),
         };
         const validation = validateSourceConfig(normalized);

package/dist/src/connectors/AppSourceConfigStore.js.map

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

package/dist/src/connectors/HostConnector.d.ts

@@ -0,0 +1,201 @@
+import { ConnectorRootAccessError, type ConnectorCapability, type ConnectorChangeEvent, type ConnectorConnectionProbe, type ConnectorCountOpts, type ConnectorDeltaRequest, type ConnectorDeltaResult, type ConnectorEventSubscription, type ConnectorFactory, type ConnectorListItem, type ConnectorMoveResult, type ConnectorPort, type ConnectorReadRawOpts, type ConnectorReadRawResult, type ConnectorReadResult, type ConnectorStatResult, type ConnectorSubscribeOpts, type ConnectorWalkOpts, type ConnectorWriteResult, type HostFsTransport, type PackageReader, type ScanContentOpts, type ScanContentResult, type SourceLiveReason, type DeviceNotReadyCode } from '@neuralis/package-system/contracts';
+/**
+ * The capability set of the `host` kind. It MUST equal the `host` connector's
+ * `capabilities` array in `package.json#neuralis.connectors` — the loader binds
+ * one kind to one set and refuses a drifted instance (boot-fatal for a native
+ * connector). `hostCapabilities.test.ts` derives the expectation from the manifest.
+ */
+export declare const HOST_CAPABILITIES: readonly ConnectorCapability[];
+/** How long a `count` is fresh for `peekCount` and `count` (`brainCountCacheTtlMs`); older, `count` serves it while one walk refreshes it. */
+export declare const COUNT_CACHE_TTL_MS = 60000;
+/** Count-cache entries one source keeps (each a key string + two numbers), fresh or stale; past it the oldest goes. */
+export declare const MAX_COUNT_CACHE_ENTRIES = 256;
+/** The folder budget of ONE package folder's watch (a device's broker clamps above). */
+export declare const PACKAGE_FOLDER_WATCH_MAX_FOLDERS = 5000;
+/** One write RPC/syscall carries at most this many bytes; a larger file goes in chunks. */
+export declare const WRITE_CHUNK_BYTES: number;
+/**
+ * The source root itself is missing or unreadable — a listing of the ROOT
+ * throws this (the abstract base is what routes and services catch); a missing
+ * sub-folder lists as empty.
+ */
+export declare class HostRootAccessError extends ConnectorRootAccessError {
+    constructor(code: 'ROOT_MISSING' | 'ROOT_PERMISSION_DENIED', rootPath: string, uri: string, cause?: unknown);
+}
+/**
+ * The fixed code a transport refusal carries (`devices_disabled`,
+ * `device_offline`, `others_denied`, `device_owner_ungranted`, …) — never its
+ * text, which can name a device path. `undefined` for anything else (an errno,
+ * a plain failure): "could not ask" and "gone" stay apart.
+ */
+export declare function transportRefusalReason(error: unknown): string | undefined;
+/** Why a device folder could not serve a call: its plane is down, or the device refused it. */
+export type HostFolderUnavailable = {
+    live: false;
+    reason: SourceLiveReason;
+    notReady?: DeviceNotReadyCode[];
+} | {
+    refused: string;
+};
+export type HostConnectorInit = {
+    source: string;
+    /** Absolute root on the transport's machine, in its flavour. */
+    root: string;
+    transport: HostFsTransport;
+    /**
+     * The root as the MACHINE's user sees it (`os_uri`): the device path, the
+     * native path, or a Docker mount's host half. `undefined` inside Docker with
+     * no host pair ⇒ `resolveOsUri` throws `OsUriUnresolvableError`.
+     */
+    osRoot?: string;
+};
+export declare class HostConnector implements ConnectorPort {
+    #private;
+    readonly kind: "host";
+    readonly source: string;
+    readonly portVersion: 4;
+    constructor(init: HostConnectorInit);
+    capabilities(): ReadonlySet<ConnectorCapability>;
+    /** The paired device this folder lives on; `undefined` for an in-process folder. */
+    get device(): string | undefined;
+    /** The root on the folder's OWN machine (a device path for a device folder) — server-side only, never serialized. */
+    get root(): string;
+    /** The root on THIS process's disk — `undefined` for a device folder (that disk is not ours). */
+    get localRoot(): string | undefined;
+    /** The transport this folder is reached through (the git engine's exec seam). */
+    get transport(): HostFsTransport;
+    probeConnection(): Promise<ConnectorConnectionProbe>;
+    /**
+     * Why a device folder could not serve a call that threw: the plane is down —
+     * answered by the SAME probe the listing's `live`/`live_reason` comes from —
+     * or the device refused it by its fixed code. `undefined` for an in-process
+     * folder and for an error that is no transport refusal: the caller keeps its
+     * own answer. One probe on a failure path only (the device verdict is cached).
+     */
+    unavailable(error: unknown): Promise<HostFolderUnavailable | undefined>;
+    /** Wiring diagnostics (operator log only — the root names a machine path). */
+    probeRoot(): Promise<{
+        rootPath: string;
+        exists: boolean;
+        readable: boolean;
+        error?: string;
+    }>;
+    list(uri: string): Promise<ConnectorListItem[]>;
+    stat(uri: string): Promise<ConnectorStatResult | null>;
+    /**
+     * The byte-exact read: the whole file or a refusal, never a prefix or a
+     * marker. Cap = `min(opts.maxBytes, brainMaxReadFileMb)`, checked before any
+     * byte moves; a file that grows past it while it is read is refused too.
+     */
+    readRaw(uri: string, opts: ConnectorReadRawOpts): Promise<ConnectorReadRawResult>;
+    /**
+     * Bytes `[offset, offset+length)` of one file and the WHOLE file's size — the
+     * byte lane's `Range` answer. Moves only that range (in transport-sized
+     * pieces); the caller bounds `length`. Not a kernel port member.
+     */
+    readByteRange(uri: string, offset: number, length: number): Promise<{
+        bytes: Uint8Array;
+        size: number;
+        mimeType: string;
+    }>;
+    /**
+     * The MODEL read: text decoded, a PDF as its text (or its rendered first
+     * page, opt-in), an image/video/audio inline as base64 under its per-MIME
+     * cap and as a `[binary file too large…]` marker above it. Same answer on
+     * both transports — the PDF helpers run on THIS server over a private copy.
+     */
+    read(uri: string): Promise<ConnectorReadResult>;
+    /**
+     * The sync media lane's PDF read (not a kernel port member): the raw bytes'
+     * sha256 and pages `first..last` rendered by the ONE renderer — none when the
+     * hash equals `unlessHash`. `null` when `pdftoppm` is not installed.
+     */
+    renderPdfPages(uri: string, opts: {
+        first: number;
+        last: number;
+        unlessHash?: string;
+    }): Promise<{
+        contentHash: string;
+        pages: Array<{
+            page: number;
+            png: Buffer;
+        }>;
+    } | null>;
+    write(uri: string, content: string | Uint8Array): Promise<ConnectorWriteResult>;
+    delete(uri: string): Promise<void>;
+    move(fromUri: string, toUri: string): Promise<ConnectorMoveResult>;
+    mkdir(uri: string): Promise<void>;
+    rmdir(uri: string): Promise<void>;
+    walk(rootUri: string, opts?: ConnectorWalkOpts): Promise<ConnectorListItem[]>;
+    /** `complete` proves absence; `walkWithStatus` exists on BOTH transports (the export's verifier reads it). */
+    walkWithStatus(rootUri: string, opts?: ConnectorWalkOpts): Promise<{
+        items: ConnectorListItem[];
+        complete: boolean;
+        truncated: boolean;
+    }>;
+    /** The last `count` for the same root and options while younger than the TTL — never I/O. */
+    peekCount(rootUri: string, opts?: ConnectorCountOpts): number | undefined;
+    /**
+     * Fresh ⇒ the cached total, or the cached FAILURE rethrown at once (a walk
+     * that failed or timed out is not tried again within the TTL; a total from
+     * before it is still answered). Expired with a total ⇒ that stale total AT
+     * ONCE while one walk refreshes it. Otherwise ⇒ the walk's answer.
+     * Concurrent callers of one key share ONE walk.
+     */
+    count(rootUri: string, opts?: ConnectorCountOpts): Promise<number>;
+    scanContent(rootUri: string, query: string, opts?: ScanContentOpts): Promise<ScanContentResult[]>;
+    /**
+     * Change events under `rootUri` from a watcher on the folder's own machine
+     * (this process's `FsWatchHub`, or the device's broker over its link, re-opened
+     * on loss with ONE `overflow {watcher_restarted}`). An `overflow` means event
+     * delivery can no longer be trusted — the consumer reconciles the source.
+     */
+    subscribeEvents(rootUri: string, listener: (event: ConnectorChangeEvent) => void, opts?: ConnectorSubscribeOpts): ConnectorEventSubscription;
+    scanDelta(request: ConnectorDeltaRequest): Promise<ConnectorDeltaResult>;
+    /**
+     * The machine path of `uri` (`os_uri`): the device's own path for a device
+     * folder, the native path, or a Docker mount's host half. Inside Docker with
+     * no host pair it THROWS `OsUriUnresolvableError` — never a container path.
+     */
+    resolveOsUri(uri: string): string;
+    /**
+     * The package-byte reader of ONE package folder (`folder` is source-relative,
+     * `isPackageFolderPath`). Every path must lie inside `<root>/<folder>` —
+     * judged lexically in the folder's own flavour before any call, then by the
+     * transport's clamp. Nothing is cached or copied: `readText`/`readBytes` are
+     * one bounded read each, `list`/`stat` one call each; `available()` is the
+     * transport's (the live link table, no RPC); `watch` rides this folder's own
+     * watch plus — on a device — the link's come-and-go.
+     */
+    packageReader(folder: string, onReachabilityChange?: (listener: () => void) => () => void): {
+        root: string;
+        reader: PackageReader;
+    };
+}
+/**
+ * An in-process `host` connector over `root` on this machine. `osRoot` is the
+ * root as the machine's user sees it: natively the root itself, in Docker the
+ * stored `hostRoot` or the os-mount pair's host half (absent ⇒ `resolveOsUri`
+ * throws, never a container path).
+ */
+export declare function inProcessHostConnector(input: {
+    source: string;
+    root: string;
+    osRoot?: string;
+}): HostConnector;
+/**
+ * The device half of a `host` source: the stored `root` must be absolute ON
+ * THAT DEVICE — its flavour is its own shape (`C:\…` Windows, `/…` POSIX; a
+ * drive-relative `C:x` or a UNC share is refused) — and the device's transport
+ * comes from agent-core. A root whose shape contradicts the platform the device
+ * claimed is refused by agent-core (`openTransport`).
+ */
+export declare function deviceHostRoot(source: string, rawRoot: unknown): string;
+/**
+ * The `host` kind's factory — ONE connector class; the STORED config picks the
+ * transport (the kernel's `sourcePlane` reads the same field). A device folder
+ * without agent-core loaded cannot be served — the binding fails and the source
+ * reads as unavailable.
+ */
+export declare const createHostConnector: ConnectorFactory;
+//# sourceMappingURL=HostConnector.d.ts.map

package/dist/src/connectors/HostConnector.d.ts.map

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