@haibun/core 4.0.0-alpha.2 → 4.0.0-alpha.3

package/build/lib/quad-store.js

@@ -1,19 +1,90 @@
 /**
- * QuadStore - In-memory quad store for observations
+ * QuadStore - In-memory quad store with optional backing store routing
  *
- * Stores observations as Subject-Predicate-Object-namedGraph quads with timestamps.
- * This is the unified data model for all shared state in Haibun.
+ * Stores quads as Subject-Predicate-Object-namedGraph with timestamps and optional properties.
+ * Backing stores can be registered for specific named graphs — writes route to the owning store,
+ * reads merge across all stores.
+ * Methods return Promises (via Promise.resolve) to satisfy the async IQuadStore interface.
  */
 export class QuadStore {
     quads = [];
+    backingStores = new Map();
+    registeredGraphs = new Set();
+    /** Register a backing store for specific named graphs. Writes route to it, reads merge. */
+    registerStore(store, namedGraphs) {
+        for (const ng of namedGraphs) {
+            this.backingStores.set(ng, store);
+            this.registeredGraphs.add(ng);
+        }
+    }
+    /** Copy backing store registrations to another QuadStore (for scenario boundary inheritance). */
+    inheritBackingStores(target) {
+        for (const [ng, store] of this.backingStores) {
+            target.backingStores.set(ng, store);
+            target.registeredGraphs.add(ng);
+        }
+    }
+    storeFor(namedGraph) {
+        return this.backingStores.get(namedGraph);
+    }
+    get allStores() {
+        return [...new Set(this.backingStores.values())];
+    }
+    set(subject, predicate, object, namedGraph, properties) {
+        const backing = this.storeFor(namedGraph);
+        if (backing)
+            return backing.set(subject, predicate, object, namedGraph, properties);
+        this.quads = this.quads.filter((q) => !(q.subject === subject && q.predicate === predicate && q.namedGraph === namedGraph));
+        this.quads.push({ subject, predicate, object, namedGraph, timestamp: Date.now(), ...(properties ? { properties } : {}) });
+        return Promise.resolve();
+    }
+    get(subject, predicate, namedGraph) {
+        if (namedGraph) {
+            const backing = this.storeFor(namedGraph);
+            if (backing)
+                return backing.get(subject, predicate, namedGraph);
+        }
+        // Search local first
+        for (let i = this.quads.length - 1; i >= 0; i--) {
+            const q = this.quads[i];
+            if (q.subject === subject && q.predicate === predicate && (namedGraph === undefined || q.namedGraph === namedGraph))
+                return Promise.resolve(q.object);
+        }
+        // Then search backing stores if no namedGraph filter
+        if (namedGraph === undefined) {
+            return this.getFromBackingStores(subject, predicate);
+        }
+        return Promise.resolve(undefined);
+    }
+    async getFromBackingStores(subject, predicate) {
+        for (const store of this.allStores) {
+            const result = await store.get(subject, predicate);
+            if (result !== undefined)
+                return result;
+        }
+        return undefined;
+    }
     add(quad) {
-        this.quads.push({
-            ...quad,
-            timestamp: Date.now(),
-        });
+        const backing = this.storeFor(quad.namedGraph);
+        if (backing)
+            return backing.add(quad);
+        this.quads.push({ ...quad, timestamp: Date.now() });
+        return Promise.resolve();
     }
-    query(pattern) {
-        return this.quads.filter(q => {
+    async query(pattern) {
+        if (pattern.namedGraph) {
+            const backing = this.storeFor(pattern.namedGraph);
+            if (backing)
+                return backing.query(pattern);
+            return this.localQuery(pattern);
+        }
+        // No namedGraph filter — merge local + all backing stores
+        const local = this.localQuery(pattern);
+        const backingResults = await Promise.all(this.allStores.map((s) => s.query(pattern)));
+        return [...local, ...backingResults.flat()].sort((a, b) => a.timestamp - b.timestamp);
+    }
+    localQuery(pattern) {
+        return this.quads.filter((q) => {
             if (pattern.subject !== undefined && q.subject !== pattern.subject)
                 return false;
             if (pattern.predicate !== undefined && q.predicate !== pattern.predicate)
@@ -25,23 +96,26 @@ export class QuadStore {
             return true;
         });
     }
-    select(subject, predicate) {
-        const matches = this.query({ subject, predicate });
-        if (matches.length === 0)
-            return undefined;
-        // Return most recent
-        return matches[matches.length - 1].object;
-    }
     clear(namedGraph) {
         if (namedGraph) {
-            this.quads = this.quads.filter(q => q.namedGraph !== namedGraph);
+            // Don't clear persistent backing stores — only clear ephemeral (local) data
+            if (this.registeredGraphs.has(namedGraph))
+                return Promise.resolve();
+            this.quads = this.quads.filter((q) => q.namedGraph !== namedGraph);
         }
         else {
+            // Clear ephemeral only
             this.quads = [];
         }
+        return Promise.resolve();
     }
     remove(pattern) {
-        this.quads = this.quads.filter(q => {
+        if (pattern.namedGraph) {
+            const backing = this.storeFor(pattern.namedGraph);
+            if (backing)
+                return backing.remove(pattern);
+        }
+        this.quads = this.quads.filter((q) => {
             if (pattern.subject !== undefined && q.subject !== pattern.subject)
                 return true;
             if (pattern.predicate !== undefined && q.predicate !== pattern.predicate)
@@ -50,11 +124,85 @@ export class QuadStore {
                 return true;
             if (pattern.namedGraph !== undefined && q.namedGraph !== pattern.namedGraph)
                 return true;
-            return false; // Match found, filter it out
+            return false;
         });
+        return Promise.resolve();
+    }
+    async all() {
+        const local = [...this.quads];
+        const backingResults = await Promise.all(this.allStores.map((s) => s.all()));
+        return [...local, ...backingResults.flat()].sort((a, b) => a.timestamp - b.timestamp);
+    }
+    // --- Vertex operations: route to backing store or local emulation ---
+    idFields = {};
+    schemas = {};
+    registerVertexType(label, schema, idField) {
+        this.schemas[label] = schema;
+        this.idFields[label] = idField;
+    }
+    async upsertVertex(label, data) {
+        const backing = this.storeFor(label);
+        if (backing)
+            return backing.upsertVertex(label, data);
+        const schema = this.schemas[label];
+        const validated = (schema ? schema.parse(data) : data);
+        const idField = this.idFields[label] ?? "id";
+        const id = String(validated[idField]);
+        if (!id)
+            throw new Error(`Missing identity field "${idField}" for ${label}`);
+        await this.remove({ subject: id, namedGraph: label });
+        for (const [key, value] of Object.entries(validated)) {
+            if (value !== undefined && value !== null) {
+                await this.add({ subject: id, predicate: key, object: value, namedGraph: label });
+            }
+        }
+        return id;
+    }
+    async getVertex(label, id) {
+        const backing = this.storeFor(label);
+        if (backing)
+            return backing.getVertex(label, id);
+        const quads = await this.query({ subject: id, namedGraph: label });
+        if (quads.length === 0)
+            return undefined;
+        const result = {};
+        for (const q of quads)
+            result[q.predicate] = q.object;
+        return result;
+    }
+    async deleteVertex(label, id) {
+        const backing = this.storeFor(label);
+        if (backing)
+            return backing.deleteVertex(label, id);
+        await this.remove({ subject: id, namedGraph: label });
+    }
+    async queryVertices(label, filters, options) {
+        const backing = this.storeFor(label);
+        if (backing)
+            return backing.queryVertices(label, filters, options);
+        const allQuads = await this.query({ namedGraph: label });
+        const subjects = [...new Set(allQuads.map((q) => q.subject))];
+        let vertices = [];
+        for (const subject of subjects) {
+            const vertex = await this.getVertex(label, subject);
+            if (vertex)
+                vertices.push(vertex);
+        }
+        if (filters) {
+            for (const [key, value] of Object.entries(filters)) {
+                vertices = vertices.filter((v) => v[key] === value);
+            }
+        }
+        const offset = options?.offset ?? 0;
+        const limit = options?.limit ?? vertices.length;
+        return vertices.slice(offset, offset + limit);
     }
-    all() {
-        return [...this.quads];
+    async distinctPropertyValues(label, property) {
+        const backing = this.storeFor(label);
+        if (backing)
+            return backing.distinctPropertyValues(label, property);
+        const quads = await this.query({ predicate: property, namedGraph: label });
+        return [...new Set(quads.map((q) => String(q.object)))].sort();
     }
 }
 //# sourceMappingURL=quad-store.js.map

package/build/lib/quad-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"quad-store.js","sourceRoot":"","sources":["../../src/lib/quad-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,OAAO,SAAS;IACZ,KAAK,GAAY,EAAE,CAAC;IAE5B,GAAG,CAAC,IAA8B;QAChC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACd,GAAG,IAAI;YACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAqB;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YAC3B,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;gBAAE,OAAO,KAAK,CAAC;YACjF,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS;gBAAE,OAAO,KAAK,CAAC;YACvF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;YAC9E,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU;gBAAE,OAAO,KAAK,CAAC;YAC1F,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,OAAe,EAAE,SAAiB;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3C,qBAAqB;QACrB,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,UAAmB;QACvB,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;QACnE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,OAAqB;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YACjC,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC;YAChF,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS;gBAAE,OAAO,IAAI,CAAC;YACtF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC;YAC7E,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU;gBAAE,OAAO,IAAI,CAAC;YACzF,OAAO,KAAK,CAAC,CAAC,6BAA6B;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"quad-store.js","sourceRoot":"","sources":["../../src/lib/quad-store.ts"],"names":[],"mappings":"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"}

package/build/lib/quad-types.d.ts

@@ -1,14 +1,68 @@
 /**
  * QuadStore Types for Core
  *
- * Minimal quad types for the unified observation model.
+ * Property graph quad model — each quad can carry optional properties,
+ * aligning with AGE's vertex properties for seamless PG persistence.
+ * All methods are async to support both in-memory and database-backed stores.
  */
+import { z } from "zod";
+export declare const DOMAIN_GRAPH_QUERY = "graph-query";
+export declare const SearchConditionSchema: z.ZodObject<{
+    predicate: z.ZodString;
+    operator: z.ZodEnum<{
+        eq: "eq";
+        contains: "contains";
+        gt: "gt";
+        lt: "lt";
+        gte: "gte";
+        lte: "lte";
+        between: "between";
+    }>;
+    value: z.ZodString;
+    value2: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const GraphQuerySchema: z.ZodObject<{
+    label: z.ZodOptional<z.ZodString>;
+    filters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        predicate: z.ZodString;
+        operator: z.ZodEnum<{
+            eq: "eq";
+            contains: "contains";
+            gt: "gt";
+            lt: "lt";
+            gte: "gte";
+            lte: "lte";
+            between: "between";
+        }>;
+        value: z.ZodString;
+        value2: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    textQuery: z.ZodOptional<z.ZodString>;
+    sortBy: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodDefault<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    accessLevel: z.ZodDefault<z.ZodEnum<{
+        private: "private";
+        public: "public";
+        opened: "opened";
+        all: "all";
+    }>>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    explain: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TGraphQuery = z.infer<typeof GraphQuerySchema>;
+export { type ResourceRels, buildResourceRels, parseTimestampValue } from "./hypermedia.js";
 export interface TQuad {
     subject: string;
     predicate: string;
     object: unknown;
     namedGraph: string;
     timestamp: number;
+    properties?: Record<string, unknown>;
 }
 export interface TQuadPattern {
     subject?: string;
@@ -16,18 +70,35 @@ export interface TQuadPattern {
     object?: unknown;
     namedGraph?: string;
 }
+/** Emit a quadObservation event via an event logger. Canonical envelope for all quad emissions. */
+export declare function emitQuadObservation(logger: {
+    emit: (e: Record<string, unknown>) => void;
+}, id: string, quad: TQuad): void;
+/** Extract quadObservation quads from haibun event log entries. */
+export declare function extractQuadsFromEvents(events: Record<string, unknown>[]): TQuad[];
 export interface IQuadStore {
-    /** Add a quad to the store */
-    add(quad: Omit<TQuad, 'timestamp'>): void;
+    /** Set a value (upserts: replaces existing quad with same subject+predicate+namedGraph) */
+    set(subject: string, predicate: string, object: unknown, namedGraph: string, properties?: Record<string, unknown>): Promise<void>;
+    /** Get the most recent value for a subject-predicate pair */
+    get(subject: string, predicate: string, namedGraph?: string): Promise<unknown | undefined>;
+    /** Add a quad to the store (appends, does not upsert) */
+    add(quad: Omit<TQuad, "timestamp">): Promise<void>;
     /** Query quads matching a pattern */
-    query(pattern: TQuadPattern): TQuad[];
-    /** Select the most recent value for a subject-predicate pair */
-    select(subject: string, predicate: string): unknown | undefined;
+    query(pattern: TQuadPattern): Promise<TQuad[]>;
     /** Clear quads, optionally filtered by namedGraph */
-    clear(namedGraph?: string): void;
+    clear(namedGraph?: string): Promise<void>;
     /** Remove quads matching a pattern */
-    remove(pattern: TQuadPattern): void;
+    remove(pattern: TQuadPattern): Promise<void>;
     /** Get all quads */
-    all(): TQuad[];
+    all(): Promise<TQuad[]>;
+    /** Vertex operations — convenience over quads. namedGraph = vertex label. */
+    upsertVertex(label: string, data: unknown): Promise<string>;
+    getVertex<T = Record<string, unknown>>(label: string, id: string): Promise<T | undefined>;
+    deleteVertex(label: string, id: string): Promise<void>;
+    queryVertices<T = Record<string, unknown>>(label: string, filters?: Record<string, unknown>, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<T[]>;
+    distinctPropertyValues(label: string, property: string): Promise<string[]>;
 }
 //# sourceMappingURL=quad-types.d.ts.map

package/build/lib/quad-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quad-types.d.ts","sourceRoot":"","sources":["../../src/lib/quad-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC;IAE1C,qCAAqC;IACrC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK,EAAE,CAAC;IAEtC,gEAAgE;IAChE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAEhE,qDAAqD;IACrD,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC,sCAAsC;IACtC,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAEpC,oBAAoB;IACpB,GAAG,IAAI,KAAK,EAAE,CAAC;CAChB"}
+{"version":3,"file":"quad-types.d.ts","sourceRoot":"","sources":["../../src/lib/quad-types.ts"],"names":[],"mappings":"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"}

package/build/lib/quad-types.js

@@ -1,7 +1,51 @@
 /**
  * QuadStore Types for Core
  *
- * Minimal quad types for the unified observation model.
+ * Property graph quad model — each quad can carry optional properties,
+ * aligning with AGE's vertex properties for seamless PG persistence.
+ * All methods are async to support both in-memory and database-backed stores.
  */
-export {};
+import { z } from "zod";
+// --- Graph query schema (core domain, used by any graph/quad query UI) ---
+export const DOMAIN_GRAPH_QUERY = "graph-query";
+export const SearchConditionSchema = z.object({
+    predicate: z.string().min(1),
+    operator: z.enum(["eq", "contains", "gt", "lt", "gte", "lte", "between"]),
+    value: z.string(),
+    value2: z.string().optional(),
+});
+export const GraphQuerySchema = z.object({
+    label: z.string().optional(),
+    filters: z.array(SearchConditionSchema).default([]),
+    textQuery: z.string().optional(),
+    sortBy: z.string().optional(),
+    sortOrder: z.enum(["asc", "desc"]).default("desc"),
+    limit: z.number().int().positive().default(50),
+    offset: z.number().int().nonnegative().default(0),
+    accessLevel: z.enum(["private", "public", "opened", "all"]).default("private"),
+    fields: z.array(z.string()).optional(),
+    explain: z.boolean().default(false),
+});
+export { buildResourceRels, parseTimestampValue } from "./hypermedia.js";
+/** Emit a quadObservation event via an event logger. Canonical envelope for all quad emissions. */
+export function emitQuadObservation(logger, id, quad) {
+    logger.emit({
+        id, timestamp: quad.timestamp, source: "haibun", level: "debug", kind: "artifact", artifactType: "json", mimetype: "application/json",
+        json: { quadObservation: quad },
+    });
+}
+/** Extract quadObservation quads from haibun event log entries. */
+export function extractQuadsFromEvents(events) {
+    const quads = [];
+    for (const e of events) {
+        if (e.kind !== "artifact" || e.artifactType !== "json")
+            continue;
+        const json = e.json;
+        const q = json?.quadObservation;
+        if (q?.subject && q.predicate && q.namedGraph) {
+            quads.push({ subject: q.subject, predicate: q.predicate, object: q.object, namedGraph: q.namedGraph, timestamp: q.timestamp ?? e.timestamp ?? Date.now(), properties: q.properties });
+        }
+    }
+    return quads;
+}
 //# sourceMappingURL=quad-types.js.map

package/build/lib/quad-types.js.map

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

package/build/lib/readline-prompter.d.ts

@@ -1,4 +1,4 @@
-import { IPrompter, TPrompt, TPromptResponse } from './prompter.js';
+import { IPrompter, TPrompt, TPromptResponse } from "./prompter.js";
 export declare class ReadlinePrompter implements IPrompter {
     private rl?;
     private currentPromptId?;

package/build/lib/readline-prompter.js

@@ -1,5 +1,5 @@
-import { createInterface } from 'readline/promises';
-import { stdin as input, stdout as output } from 'process';
+import { createInterface } from "readline/promises";
+import { stdin as input, stdout as output } from "process";
 export class ReadlinePrompter {
     rl;
     currentPromptId;
@@ -14,10 +14,10 @@ export class ReadlinePrompter {
             output,
             history: this.history,
             historySize: 100,
-            removeHistoryDuplicates: true
+            removeHistoryDuplicates: true,
         });
         try {
-            const answer = await this.rl.question(`${prompt.message} ${prompt.options?.join(', ') ?? ''}: `);
+            const answer = await this.rl.question(`${prompt.message} ${prompt.options?.join(", ") ?? ""}: `);
             if (answer && answer.trim() && !this.history.includes(answer.trim())) {
                 this.history.unshift(answer.trim());
                 if (this.history.length > 100) {

package/build/lib/remote-stepper-proxy.d.ts

@@ -0,0 +1,56 @@
+/**
+ * remote-stepper-proxy.ts
+ *
+ * Client-side proxy for a remote haibun host. Fetches step descriptors via
+ * the host's step.list RPC endpoint, then injects proxy StepTools into
+ * the parent registry. Each proxy handler forwards calls over HTTP with
+ * an Authorization: Bearer header.
+ *
+ * Follows the same pattern as SubprocessTransport.injectInto() but uses
+ * HTTP/JSON-RPC instead of Node.js fork() IPC.
+ */
+import { AStepper } from "./astepper.js";
+import type { TWorld } from "./execution.js";
+import { type StepRegistry } from "./step-dispatch.js";
+import type { StepDescriptor } from "./stepper-registry.js";
+export declare class RemoteStepperProxy extends AStepper {
+    private remoteUrl;
+    private token?;
+    readonly name: string;
+    private stepDescriptors;
+    private rpc;
+    /**
+     * Remote host's hostId, discovered at setWorld via session.beginAction.
+     * Used to prefix registry keys so multiple remotes (and local) don't
+     * collide on identical method names.
+     */
+    private hostId;
+    constructor(remoteUrl: string, token?: string);
+    setWorld(world: TWorld, steppers: AStepper[]): Promise<void>;
+    /** Read hostId from session.beginAction so injected tools carry a correct prefix. */
+    private discoverHostId;
+    /** The remote host's hostId. Undefined before setWorld completes. */
+    get remoteHostId(): number | undefined;
+    /**
+     * Fetch step.list from the remote host. step.list is introspection,
+     * explicitly exempt from the seqPath-required rule (per commit 5), so
+     * we pass an empty seqPath — the remote's step.list handler doesn't
+     * look at it.
+     */
+    private fetchStepDescriptors;
+    /**
+     * Inject proxy StepTools into the parent registry. Remote tools are
+     * keyed `${hostId}:${method}` so they never collide with local tools
+     * (bare method names) or with other remote hosts.
+     */
+    injectInto(registry: StepRegistry): void;
+    /** Call a step on the remote host via shared RpcClient. */
+    private call;
+    /** IStepTransport.attach — duck-typed, no import needed from web-server-hono. */
+    attach(registry: StepRegistry, _webserver: unknown): void;
+    /** IStepTransport.detach — nothing to clean up for HTTP transport. */
+    detach(): void;
+    get descriptors(): StepDescriptor[];
+    steps: {};
+}
+//# sourceMappingURL=remote-stepper-proxy.d.ts.map

package/build/lib/remote-stepper-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-stepper-proxy.d.ts","sourceRoot":"","sources":["../../src/lib/remote-stepper-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,EAAiB,KAAK,YAAY,EAAwB,MAAM,oBAAoB,CAAC;AAC5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,qBAAa,kBAAmB,SAAQ,QAAQ;IAY9C,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,KAAK,CAAC;IAZf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,GAAG,CAAY;IACvB;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAqB;gBAG1B,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM;IASjB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlE,qFAAqF;YACvE,cAAc;IAY5B,qEAAqE;IACrE,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAErC;IAED;;;;;OAKG;YACW,oBAAoB;IAQlC;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IA+BxC,2DAA2D;YAC7C,IAAI;IAQlB,iFAAiF;IACjF,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IAIzD,sEAAsE;IACtE,MAAM,IAAI,IAAI;IAId,IAAI,WAAW,IAAI,cAAc,EAAE,CAElC;IAED,KAAK,KAAM;CACX"}

package/build/lib/remote-stepper-proxy.js

@@ -0,0 +1,123 @@
+/**
+ * remote-stepper-proxy.ts
+ *
+ * Client-side proxy for a remote haibun host. Fetches step descriptors via
+ * the host's step.list RPC endpoint, then injects proxy StepTools into
+ * the parent registry. Each proxy handler forwards calls over HTTP with
+ * an Authorization: Bearer header.
+ *
+ * Follows the same pattern as SubprocessTransport.injectInto() but uses
+ * HTTP/JSON-RPC instead of Node.js fork() IPC.
+ */
+import { AStepper } from "./astepper.js";
+import { actionNotOK } from "./util/index.js";
+import { hostScopedMethodName } from "./step-dispatch.js";
+import { RpcClient } from "./rpc-client.js";
+export class RemoteStepperProxy extends AStepper {
+    remoteUrl;
+    token;
+    name;
+    stepDescriptors = [];
+    rpc;
+    /**
+     * Remote host's hostId, discovered at setWorld via session.beginAction.
+     * Used to prefix registry keys so multiple remotes (and local) don't
+     * collide on identical method names.
+     */
+    hostId;
+    constructor(remoteUrl, token) {
+        super();
+        this.remoteUrl = remoteUrl;
+        this.token = token;
+        const host = new URL(remoteUrl).host;
+        this.name = `RemoteProxy_${host.replace(/[^a-zA-Z0-9]/g, "_")}`;
+        this.description = `Proxy for remote stepper host at ${remoteUrl}`;
+        this.rpc = new RpcClient({ baseUrl: remoteUrl, capabilityToken: token });
+    }
+    async setWorld(world, steppers) {
+        await super.setWorld(world, steppers);
+        await this.discoverHostId();
+        await this.fetchStepDescriptors();
+    }
+    /** Read hostId from session.beginAction so injected tools carry a correct prefix. */
+    async discoverHostId() {
+        const result = await this.rpc.call("session.beginAction", {}, []);
+        if ("error" in result) {
+            throw new Error(`RemoteStepperProxy: session.beginAction failed at ${this.remoteUrl}: ${result.error}`);
+        }
+        const id = result.hostId ?? result.seqPath?.[0];
+        if (typeof id !== "number") {
+            throw new Error(`RemoteStepperProxy: session.beginAction at ${this.remoteUrl} did not surface a hostId`);
+        }
+        this.hostId = id;
+    }
+    /** The remote host's hostId. Undefined before setWorld completes. */
+    get remoteHostId() {
+        return this.hostId;
+    }
+    /**
+     * Fetch step.list from the remote host. step.list is introspection,
+     * explicitly exempt from the seqPath-required rule (per commit 5), so
+     * we pass an empty seqPath — the remote's step.list handler doesn't
+     * look at it.
+     */
+    async fetchStepDescriptors() {
+        const result = await this.rpc.call("step.list", {}, []);
+        if ("error" in result) {
+            throw new Error(`RemoteStepperProxy: step.list failed at ${this.remoteUrl}: ${result.error}`);
+        }
+        this.stepDescriptors = result.steps ?? [];
+    }
+    /**
+     * Inject proxy StepTools into the parent registry. Remote tools are
+     * keyed `${hostId}:${method}` so they never collide with local tools
+     * (bare method names) or with other remote hosts.
+     */
+    injectInto(registry) {
+        if (this.hostId === undefined)
+            throw new Error("RemoteStepperProxy.injectInto called before setWorld discovered the host id");
+        for (const descriptor of this.stepDescriptors) {
+            const prefixedMethod = hostScopedMethodName(this.hostId, descriptor.method);
+            const tool = {
+                name: prefixedMethod,
+                description: descriptor.pattern,
+                inputSchema: descriptor.inputSchema ?? { type: "object" },
+                paramSchemas: new Map(),
+                paramDomainKeys: new Map(),
+                stepperName: descriptor.stepperName,
+                stepName: descriptor.stepName,
+                capability: descriptor.capability,
+                isAsync: true,
+                transport: "remote",
+                remoteHost: new URL(this.remoteUrl).host,
+                // Dispatch over RPC using the un-prefixed method name — the prefix is
+                // a local registry-naming concern, not part of the wire call.
+                handler: (_featureStep, _world) => this.call(descriptor.method, _featureStep.action?.stepValuesMap
+                    ? Object.fromEntries(Object.entries(_featureStep.action.stepValuesMap).map(([k, v]) => [k, v.term]))
+                    : {}, _featureStep.seqPath),
+            };
+            registry.set(tool);
+        }
+    }
+    /** Call a step on the remote host via shared RpcClient. */
+    async call(method, params, seqPath = []) {
+        const result = await this.rpc.call(method, params, seqPath);
+        if ("error" in result && typeof result.error === "string") {
+            return actionNotOK(`${method}: ${result.error}`);
+        }
+        return { ok: true, products: result };
+    }
+    /** IStepTransport.attach — duck-typed, no import needed from web-server-hono. */
+    attach(registry, _webserver) {
+        this.injectInto(registry);
+    }
+    /** IStepTransport.detach — nothing to clean up for HTTP transport. */
+    detach() {
+        /* no-op */
+    }
+    get descriptors() {
+        return this.stepDescriptors;
+    }
+    steps = {};
+}
+//# sourceMappingURL=remote-stepper-proxy.js.map