@thierry-gilgen-ict/engawa-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thierry Gilgen ICT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @thierry-gilgen-ict/engawa-core
+
+Framework-independent core for Engawa: configuration, normalized resources, content adapters, and the `createEngawa` factory.
+
+This package has no MCP, HTTP, or UI dependencies.

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+import { z } from "zod";
+export declare const ENGAWA_VERSION = "0.1.0";
+export declare const IMPLEMENTATION_PROFILE_VERSION = "0.1";
+export declare const MCP_PROTOCOL_BASELINE = "2026-07-28";
+/** Documented absolute safety ceilings for Engawa config (not hidden MCP-specific limits). */
+export declare const MAX_SEARCH_QUERY_LENGTH_CEILING = 500;
+export declare const MAX_SEARCH_RESULTS_CEILING = 50;
+export declare const resourceIdSchema: z.ZodString;
+export declare const engawaConfigSchema: z.ZodObject<{
+    site: z.ZodObject<{
+        name: z.ZodString;
+        canonicalUrl: z.ZodString;
+        description: z.ZodString;
+        language: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    agentInterface: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        public: z.ZodBoolean;
+    }, z.core.$strip>;
+    content: z.ZodDefault<z.ZodObject<{
+        maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+        maxSearchResults: z.ZodDefault<z.ZodNumber>;
+        maxSearchQueryLength: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    security: z.ZodObject<{
+        publicDefault: z.ZodLiteral<"read-only">;
+    }, z.core.$strip>;
+    metadata: z.ZodObject<{
+        version: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type EngawaConfig = z.infer<typeof engawaConfigSchema>;
+export declare const engawaResourceSchema: z.ZodObject<{
+    id: z.ZodString;
+    uri: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodString;
+    content: z.ZodString;
+    canonicalUrl: z.ZodString;
+    lastModified: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type EngawaResource = z.infer<typeof engawaResourceSchema>;
+export interface ContentAdapter {
+    listResources(): Promise<EngawaResource[]>;
+    getResource(idOrUri: string): Promise<EngawaResource | undefined>;
+    search(query: string): Promise<EngawaResource[]>;
+}
+export interface AgentInterfaceMetadata {
+    engawaVersion: string;
+    implementationProfile: string;
+    mcpProtocolBaseline: string;
+}
+export interface Engawa {
+    readonly config: EngawaConfig;
+    readonly adapter: ContentAdapter;
+    readonly metadata: AgentInterfaceMetadata;
+    listResources(): Promise<EngawaResource[]>;
+    getResource(idOrUri: string): Promise<EngawaResource | undefined>;
+    search(query: string): Promise<EngawaResource[]>;
+}
+export declare function validateResourceId(id: string): string;
+export declare function normalizeCanonicalUrl(url: string): string;
+export declare function getCanonicalPath(canonicalUrl: string): string;
+export declare function buildResourceUri(canonicalUrl: string, id: string): string;
+export declare function validateEngawaConfig(input: unknown): EngawaConfig;
+export declare function validateAdapterResource(raw: unknown, config: EngawaConfig): EngawaResource;
+export declare function createEngawa(configInput: unknown, adapter: ContentAdapter): Engawa;
+export { StaticContentAdapter, type StaticResourceInput } from "./static-adapter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc,UAAU,CAAC;AACtC,eAAO,MAAM,8BAA8B,QAAQ,CAAC;AACpD,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAElD,8FAA8F;AAC9F,eAAO,MAAM,+BAA+B,MAAM,CAAC;AACnD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAS7C,eAAO,MAAM,gBAAgB,aAO1B,CAAC;AAEJ,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;iBAiC7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAU/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAClE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAClE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAClD;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAqBzD;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAMzE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAUjE;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,cAAc,CAmB1F;AAqCD,wBAAgB,YAAY,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CA+BlF;AAED,OAAO,EAAE,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,182 @@
+import { z } from "zod";
+export const ENGAWA_VERSION = "0.1.0";
+export const IMPLEMENTATION_PROFILE_VERSION = "0.1";
+export const MCP_PROTOCOL_BASELINE = "2026-07-28";
+/** Documented absolute safety ceilings for Engawa config (not hidden MCP-specific limits). */
+export const MAX_SEARCH_QUERY_LENGTH_CEILING = 500;
+export const MAX_SEARCH_RESULTS_CEILING = 50;
+const httpAbsoluteUrlSchema = z
+    .string()
+    .url()
+    .refine((url) => url.startsWith("http://") || url.startsWith("https://"), {
+    message: "canonicalUrl must be an absolute http(s) URL",
+});
+export const resourceIdSchema = z
+    .string()
+    .min(1)
+    .max(128)
+    .regex(/^[a-zA-Z0-9._-]+$/, "Resource id must contain only letters, digits, dots, underscores, and hyphens");
+export const engawaConfigSchema = z.object({
+    site: z.object({
+        name: z.string().min(1),
+        canonicalUrl: httpAbsoluteUrlSchema,
+        description: z.string().min(1),
+        language: z.string().min(1).default("en"),
+    }),
+    agentInterface: z.object({
+        enabled: z.boolean(),
+        public: z.boolean(),
+    }),
+    content: z
+        .object({
+        maxResourceBytes: z.number().int().positive().default(65536),
+        maxSearchResults: z.number().int().positive().max(MAX_SEARCH_RESULTS_CEILING).default(10),
+        maxSearchQueryLength: z
+            .number()
+            .int()
+            .positive()
+            .max(MAX_SEARCH_QUERY_LENGTH_CEILING)
+            .default(200),
+    })
+        .default({
+        maxResourceBytes: 65536,
+        maxSearchResults: 10,
+        maxSearchQueryLength: 200,
+    }),
+    security: z.object({
+        publicDefault: z.literal("read-only"),
+    }),
+    metadata: z.object({
+        version: z.string().min(1),
+    }),
+});
+export const engawaResourceSchema = z.object({
+    id: resourceIdSchema,
+    uri: z.string().min(1),
+    title: z.string().min(1),
+    description: z.string().optional(),
+    mimeType: z.string().min(1),
+    content: z.string(),
+    canonicalUrl: httpAbsoluteUrlSchema,
+    lastModified: z.string().datetime().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+export function validateResourceId(id) {
+    return resourceIdSchema.parse(id);
+}
+export function normalizeCanonicalUrl(url) {
+    const parsed = new URL(url);
+    if (parsed.username || parsed.password) {
+        throw new Error("canonicalUrl must not contain username or password credentials");
+    }
+    if (parsed.search) {
+        throw new Error("canonicalUrl must not contain a query string");
+    }
+    if (parsed.hash) {
+        throw new Error("canonicalUrl must not contain a fragment");
+    }
+    let path = parsed.pathname;
+    if (path.length > 1 && path.endsWith("/")) {
+        path = path.slice(0, -1);
+    }
+    parsed.pathname = path;
+    const normalized = parsed.toString().replace(/\/$/, "");
+    return normalized || parsed.origin;
+}
+export function getCanonicalPath(canonicalUrl) {
+    const pathname = new URL(canonicalUrl).pathname;
+    if (pathname === "/" || pathname === "") {
+        return "";
+    }
+    return pathname;
+}
+export function buildResourceUri(canonicalUrl, id) {
+    validateResourceId(id);
+    const parsed = new URL(canonicalUrl);
+    const path = getCanonicalPath(canonicalUrl);
+    const encodedId = encodeURIComponent(id);
+    return `engawa://${parsed.host}${path}/r/${encodedId}`;
+}
+export function validateEngawaConfig(input) {
+    const parsed = engawaConfigSchema.parse(input);
+    const canonicalUrl = normalizeCanonicalUrl(parsed.site.canonicalUrl);
+    return {
+        ...parsed,
+        site: {
+            ...parsed.site,
+            canonicalUrl,
+        },
+    };
+}
+export function validateAdapterResource(raw, config) {
+    const resource = engawaResourceSchema.parse(raw);
+    const siteBase = config.site.canonicalUrl;
+    const expectedUri = buildResourceUri(siteBase, resource.id);
+    if (resource.uri !== expectedUri) {
+        throw new Error(`Resource URI mismatch for id "${resource.id}": expected "${expectedUri}", got "${resource.uri}"`);
+    }
+    const normalizedPageUrl = normalizeCanonicalUrl(resource.canonicalUrl);
+    if (normalizedPageUrl !== siteBase && !normalizedPageUrl.startsWith(`${siteBase}/`)) {
+        throw new Error(`Resource canonicalUrl "${resource.canonicalUrl}" is outside site base "${siteBase}"`);
+    }
+    return { ...resource, canonicalUrl: normalizedPageUrl };
+}
+function enforceContentBounds(resource, maxBytes) {
+    const byteLength = Buffer.byteLength(resource.content, "utf8");
+    if (byteLength > maxBytes) {
+        throw new Error(`Resource "${resource.id}" exceeds maxResourceBytes (${byteLength} > ${maxBytes})`);
+    }
+    return resource;
+}
+function normalizeSearchQuery(query, maxLength) {
+    const trimmed = query.trim();
+    if (trimmed.length === 0) {
+        throw new Error("Search query must not be empty");
+    }
+    if (trimmed.length > maxLength) {
+        throw new Error(`Search query exceeds max length (${trimmed.length} > ${maxLength})`);
+    }
+    for (const char of trimmed) {
+        const code = char.charCodeAt(0);
+        if (code < 32 && code !== 9 && code !== 10 && code !== 13) {
+            throw new Error("Search query contains invalid control characters");
+        }
+    }
+    return trimmed;
+}
+function validateAndBoundResource(raw, config, maxBytes) {
+    return enforceContentBounds(validateAdapterResource(raw, config), maxBytes);
+}
+export function createEngawa(configInput, adapter) {
+    const config = validateEngawaConfig(configInput);
+    const maxBytes = config.content.maxResourceBytes;
+    const maxResults = config.content.maxSearchResults;
+    const maxQueryLength = config.content.maxSearchQueryLength;
+    const metadata = {
+        engawaVersion: ENGAWA_VERSION,
+        implementationProfile: IMPLEMENTATION_PROFILE_VERSION,
+        mcpProtocolBaseline: MCP_PROTOCOL_BASELINE,
+    };
+    return {
+        config,
+        adapter,
+        metadata,
+        async listResources() {
+            const resources = await adapter.listResources();
+            return resources.map((r) => validateAndBoundResource(r, config, maxBytes));
+        },
+        async getResource(idOrUri) {
+            const resource = await adapter.getResource(idOrUri);
+            if (!resource)
+                return undefined;
+            return validateAndBoundResource(resource, config, maxBytes);
+        },
+        async search(query) {
+            const normalized = normalizeSearchQuery(query, maxQueryLength);
+            const results = await adapter.search(normalized);
+            return results.slice(0, maxResults).map((r) => validateAndBoundResource(r, config, maxBytes));
+        },
+    };
+}
+export { StaticContentAdapter } from "./static-adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/static-adapter.d.ts

@@ -0,0 +1,20 @@
+import { type EngawaResource } from "./index.js";
+export interface StaticResourceInput {
+    id: string;
+    title: string;
+    description?: string;
+    mimeType?: string;
+    content: string;
+    path?: string;
+    lastModified?: string;
+    metadata?: Record<string, unknown>;
+}
+export declare class StaticContentAdapter {
+    private readonly resources;
+    private readonly uriIndex;
+    constructor(canonicalUrl: string, inputs: StaticResourceInput[]);
+    listResources(): Promise<EngawaResource[]>;
+    getResource(idOrUri: string): Promise<EngawaResource | undefined>;
+    search(query: string): Promise<EngawaResource[]>;
+}
+//# sourceMappingURL=static-adapter.d.ts.map

package/dist/static-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-adapter.d.ts","sourceRoot":"","sources":["../src/static-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAGpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;gBAEnC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE;IA6BzD,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI1C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAQjE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAUvD"}

package/dist/static-adapter.js

@@ -0,0 +1,54 @@
+import { buildResourceUri, normalizeCanonicalUrl, validateResourceId, } from "./index.js";
+export class StaticContentAdapter {
+    resources;
+    uriIndex;
+    constructor(canonicalUrl, inputs) {
+        const normalizedBase = normalizeCanonicalUrl(canonicalUrl);
+        this.resources = new Map();
+        this.uriIndex = new Map();
+        for (const input of inputs) {
+            const id = validateResourceId(input.id);
+            if (this.resources.has(id)) {
+                throw new Error(`Duplicate resource id "${id}"`);
+            }
+            const path = input.path ?? `/${id}.md`;
+            const canonical = `${normalizedBase}${path.startsWith("/") ? path : `/${path}`}`;
+            const resource = {
+                id,
+                uri: buildResourceUri(normalizedBase, id),
+                title: input.title,
+                description: input.description,
+                mimeType: input.mimeType ?? "text/markdown",
+                content: input.content,
+                canonicalUrl: canonical,
+                lastModified: input.lastModified,
+                metadata: input.metadata,
+            };
+            this.resources.set(resource.id, resource);
+            this.uriIndex.set(resource.uri, resource.id);
+        }
+    }
+    async listResources() {
+        return Array.from(this.resources.values()).sort((a, b) => a.id.localeCompare(b.id));
+    }
+    async getResource(idOrUri) {
+        const byId = this.resources.get(idOrUri);
+        if (byId)
+            return byId;
+        const id = this.uriIndex.get(idOrUri);
+        if (id)
+            return this.resources.get(id);
+        return undefined;
+    }
+    async search(query) {
+        const lower = query.toLowerCase();
+        const matches = Array.from(this.resources.values()).filter((resource) => {
+            const haystack = [resource.id, resource.title, resource.description ?? "", resource.content]
+                .join(" ")
+                .toLowerCase();
+            return haystack.includes(lower);
+        });
+        return matches.sort((a, b) => a.id.localeCompare(b.id));
+    }
+}
+//# sourceMappingURL=static-adapter.js.map

package/dist/static-adapter.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@thierry-gilgen-ict/engawa-core",
+  "version": "0.1.0",
+  "description": "Framework-independent core for Engawa agent-native websites",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thierry-gilgen-ict/engawa.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/thierry-gilgen-ict/engawa/issues"
+  },
+  "homepage": "https://github.com/thierry-gilgen-ict/engawa#readme",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --config ../../vitest.config.ts packages/core"
+  },
+  "dependencies": {
+    "zod": "^4.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}