@dinilmusick/gutts 1.1.0 → 1.2.0

package/.krusbl-release-attestation.json

@@ -1,8 +1,8 @@
 {
   "schema": 1,
   "packageName": "@dinilmusick/gutts",
-  "version": "1.1.0",
-  "sourceCommit": "25fe2f36405852cc7344365cdbdf458f9f788168",
+  "version": "1.2.0",
+  "sourceCommit": "2a1a7292a15c3872c959adc656508e08693c6bc3",
   "releaseWorkflow": "npm Release",
-  "workflowRunId": "40941611934"
+  "workflowRunId": "41188970179"
 }

package/dist/index.d.ts

@@ -6,4 +6,5 @@ export * from "./numbers/number-concepts.js";
 export * from "./urls/url-concepts.js";
 export * from "./api/index.js";
 export * from "./models/index.js";
+export * from "./semantic-input/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -6,4 +6,5 @@ export * from "./numbers/number-concepts.js";
 export * from "./urls/url-concepts.js";
 export * from "./api/index.js";
 export * from "./models/index.js";
+export * from "./semantic-input/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC"}

package/dist/semantic-input/index.d.ts

@@ -0,0 +1,42 @@
+export type SemanticInputSchema = {
+    type: string;
+    properties?: Record<string, SemanticInputSchema>;
+    required?: readonly string[];
+    enum?: readonly unknown[];
+    items?: SemanticInputSchema;
+    description?: string;
+    [key: string]: unknown;
+};
+export type SemanticInputContext = {
+    page?: string;
+    section?: string;
+    field?: string;
+    label?: string;
+    description?: string;
+    semanticType?: string;
+    vocabulary?: readonly string[];
+    examples?: readonly string[];
+    constraints?: readonly string[];
+};
+export type SemanticInputRequest = {
+    input: string;
+    schema: SemanticInputSchema;
+    context?: SemanticInputContext;
+    candidates?: readonly string[];
+    preserveRawInput?: boolean;
+};
+export type SemanticInputCandidate = {
+    value: string;
+    similarity?: number | undefined;
+    relevance?: number | undefined;
+};
+export type SemanticInputResolution<T = unknown> = {
+    status: "resolved" | "ambiguous" | "invalid";
+    value?: T;
+    rawInput?: string;
+    candidates: readonly SemanticInputCandidate[];
+    modelOutput: unknown;
+};
+export declare function rankSemanticInputCandidates(input: string, candidates: readonly string[]): Promise<readonly SemanticInputCandidate[]>;
+export declare function resolveSemanticInput<T = unknown>(request: SemanticInputRequest): Promise<SemanticInputResolution<T>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/semantic-input/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/semantic-input/index.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,uBAAuB,CAAC,CAAC,GAAG,OAAO,IAAI;IACjD,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;IAC7C,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC9C,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AA8BF,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,OAAO,CAAC,SAAS,sBAAsB,EAAE,CAAC,CAiB5C;AAED,wBAAsB,oBAAoB,CAAC,CAAC,GAAG,OAAO,EACpD,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAgErC"}

package/dist/semantic-input/index.js

@@ -0,0 +1,110 @@
+import { EttinReranker17M } from "../models/ettin/index.js";
+import { MiniLM } from "../models/minilm/index.js";
+import { Needle3 } from "../models/needle3/index.js";
+function unwrapModelOutput(output) {
+    if (!output || typeof output !== "object")
+        return output;
+    const record = output;
+    for (const key of ["output", "result", "data", "structuredOutput"]) {
+        if (key in record)
+            return record[key];
+    }
+    return output;
+}
+function buildPrompt(request) {
+    return [
+        "Convert the natural-language input into the supplied target schema.",
+        "Return only data conforming to the target schema. Never invent information.",
+        request.context?.page ? `Page: ${request.context.page}` : "",
+        request.context?.section ? `Section: ${request.context.section}` : "",
+        request.context?.field ? `Field: ${request.context.field}` : "",
+        request.context?.label ? `Label: ${request.context.label}` : "",
+        request.context?.description ? `Description: ${request.context.description}` : "",
+        request.context?.semanticType ? `Semantic type: ${request.context.semanticType}` : "",
+        request.context?.vocabulary?.length ? `Vocabulary: ${request.context.vocabulary.join(", ")}` : "",
+        request.context?.examples?.length ? `Examples: ${request.context.examples.join(" | ")}` : "",
+        request.context?.constraints?.length ? `Constraints: ${request.context.constraints.join("; ")}` : "",
+        request.candidates?.length ? `Candidate values: ${request.candidates.join(" | ")}` : "",
+        `Target schema: ${JSON.stringify(request.schema)}`,
+        `Input: ${request.input}`,
+    ].filter(Boolean).join("\n");
+}
+export async function rankSemanticInputCandidates(input, candidates) {
+    if (candidates.length === 0)
+        return [];
+    const similarityModel = new MiniLM();
+    const reranker = new EttinReranker17M();
+    const similarities = await Promise.all(candidates.map((candidate) => similarityModel.similarity({ left: input, right: candidate })));
+    const relevance = await reranker.rerank({ query: input, candidates });
+    return candidates
+        .map((value, index) => ({ value, similarity: similarities[index], relevance: relevance[index] }))
+        .sort((a, b) => {
+        const relDiff = (b.relevance ?? -Infinity) - (a.relevance ?? -Infinity);
+        if (relDiff !== 0)
+            return relDiff;
+        const simDiff = (b.similarity ?? -Infinity) - (a.similarity ?? -Infinity);
+        if (simDiff !== 0)
+            return simDiff;
+        return a.value.localeCompare(b.value);
+    });
+}
+export async function resolveSemanticInput(request) {
+    if (!request.input || !request.input.trim()) {
+        return {
+            status: "invalid",
+            ...(request.preserveRawInput ? { rawInput: request.input } : {}),
+            candidates: [],
+            modelOutput: undefined,
+        };
+    }
+    const candidateList = request.candidates?.length
+        ? request.candidates
+        : (request.context?.vocabulary ?? []);
+    const candidates = candidateList.length
+        ? await rankSemanticInputCandidates(request.input, candidateList)
+        : [];
+    const needle = new Needle3();
+    let rawOutput;
+    try {
+        rawOutput = await needle.complete({
+            prompt: buildPrompt(request),
+            schema: request.schema,
+        });
+    }
+    catch {
+        return {
+            status: "invalid",
+            ...(request.preserveRawInput ? { rawInput: request.input } : {}),
+            candidates,
+            modelOutput: undefined,
+        };
+    }
+    const modelOutput = unwrapModelOutput(rawOutput);
+    if (modelOutput === undefined || modelOutput === null || modelOutput === "") {
+        return {
+            status: "invalid",
+            ...(request.preserveRawInput ? { rawInput: request.input } : {}),
+            candidates,
+            modelOutput,
+        };
+    }
+    const value = (candidates.length && typeof modelOutput === "string"
+        ? candidates[0]?.value
+        : modelOutput);
+    if (value === undefined || value === null) {
+        return {
+            status: candidates.length > 1 ? "ambiguous" : "invalid",
+            ...(request.preserveRawInput ? { rawInput: request.input } : {}),
+            candidates,
+            modelOutput,
+        };
+    }
+    return {
+        status: "resolved",
+        value,
+        ...(request.preserveRawInput ? { rawInput: request.input } : {}),
+        candidates,
+        modelOutput,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/semantic-input/index.js.map

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

package/dist/semantic-input/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/semantic-input/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/semantic-input/index.test.ts"],"names":[],"mappings":""}

package/dist/semantic-input/index.test.js

@@ -0,0 +1,211 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const completeMock = vi.fn();
+const similarityMock = vi.fn();
+const rerankMock = vi.fn();
+vi.mock("../models/needle3/index.js", () => ({
+    Needle3: class {
+        complete(args) {
+            return completeMock(args);
+        }
+    },
+}));
+vi.mock("../models/minilm/index.js", () => ({
+    MiniLM: class {
+        similarity(args) {
+            return similarityMock(args);
+        }
+    },
+}));
+vi.mock("../models/ettin/index.js", () => ({
+    EttinReranker17M: class {
+        rerank(args) {
+            return rerankMock(args);
+        }
+    },
+}));
+import { rankSemanticInputCandidates, resolveSemanticInput } from "./index.js";
+describe("GutTS universal semantic input", () => {
+    beforeEach(() => {
+        vi.resetAllMocks();
+        similarityMock.mockImplementation(async () => 0.5);
+        rerankMock.mockImplementation(async ({ candidates }) => candidates.map((_, i) => candidates.length - i));
+        completeMock.mockImplementation(async () => ({ output: "default" }));
+    });
+    it("1. Needle receives the target schema", async () => {
+        const targetSchema = { type: "object", properties: { age: { type: "integer" } }, required: ["age"] };
+        completeMock.mockResolvedValueOnce({ output: { age: 32 } });
+        await resolveSemanticInput({
+            input: "I am thirty-two",
+            schema: targetSchema,
+        });
+        expect(completeMock).toHaveBeenCalledWith(expect.objectContaining({
+            schema: targetSchema,
+        }));
+    });
+    it("2. Context is included in semantic resolution", async () => {
+        completeMock.mockResolvedValueOnce({ output: { country: "Canada" } });
+        await resolveSemanticInput({
+            input: "from Toronto",
+            schema: { type: "object", properties: { country: { type: "string" } } },
+            context: {
+                page: "Profile",
+                section: "Geography",
+                field: "originCountry",
+                label: "Origin Country",
+                description: "Country of residence",
+                semanticType: "geo-country",
+                vocabulary: ["Canada", "USA"],
+                examples: ["Canada", "Mexico"],
+                constraints: ["Must be ISO compliant"],
+            },
+        });
+        expect(completeMock).toHaveBeenCalled();
+        const callArgs = completeMock.mock.calls[0]?.[0];
+        expect(callArgs.prompt).toContain("Page: Profile");
+        expect(callArgs.prompt).toContain("Section: Geography");
+        expect(callArgs.prompt).toContain("Field: originCountry");
+        expect(callArgs.prompt).toContain("Label: Origin Country");
+        expect(callArgs.prompt).toContain("Description: Country of residence");
+        expect(callArgs.prompt).toContain("Semantic type: geo-country");
+        expect(callArgs.prompt).toContain("Vocabulary: Canada, USA");
+        expect(callArgs.prompt).toContain("Examples: Canada | Mexico");
+        expect(callArgs.prompt).toContain("Constraints: Must be ISO compliant");
+    });
+    it("3. Natural language is converted into structured output", async () => {
+        completeMock.mockResolvedValueOnce({
+            output: {
+                quantity: 5,
+                item: "apples",
+            },
+        });
+        const result = await resolveSemanticInput({
+            input: "five apples please",
+            schema: {
+                type: "object",
+                properties: { quantity: { type: "integer" }, item: { type: "string" } },
+            },
+        });
+        expect(result.status).toBe("resolved");
+        expect(result.value).toEqual({ quantity: 5, item: "apples" });
+    });
+    it("4. Candidate ranking uses existing MiniLM + Ettin models", async () => {
+        similarityMock.mockImplementation(async ({ right }) => (right === "May" ? 0.88 : 0.42));
+        rerankMock.mockResolvedValueOnce([10.5, 2.1]);
+        const ranked = await rankSemanticInputCandidates("mage", ["May", "March"]);
+        expect(similarityMock).toHaveBeenCalledTimes(2);
+        expect(rerankMock).toHaveBeenCalledWith(expect.objectContaining({
+            query: "mage",
+            candidates: ["May", "March"],
+        }));
+        expect(ranked[0]?.value).toBe("May");
+        expect(ranked[0]?.similarity).toBe(0.88);
+        expect(ranked[0]?.relevance).toBe(10.5);
+    });
+    it("5. Candidate ordering is deterministic with tie-breaking", async () => {
+        similarityMock.mockResolvedValue(0.5);
+        // All candidates return equal relevance score
+        rerankMock.mockResolvedValueOnce([5.0, 5.0, 5.0]);
+        const ranked = await rankSemanticInputCandidates("query", ["Zeta", "Alpha", "Beta"]);
+        // Equal relevance and similarity falls back to alphabetical
+        expect(ranked.map((c) => c.value)).toEqual(["Alpha", "Beta", "Zeta"]);
+    });
+    it("6. Empty candidate sets work correctly", async () => {
+        completeMock.mockResolvedValueOnce({ output: "Plain output" });
+        const ranked = await rankSemanticInputCandidates("query", []);
+        expect(ranked).toEqual([]);
+        const result = await resolveSemanticInput({
+            input: "Plain query",
+            schema: { type: "string" },
+            candidates: [],
+        });
+        expect(result.status).toBe("resolved");
+        expect(result.value).toBe("Plain output");
+        expect(result.candidates).toEqual([]);
+    });
+    it("7. Invalid/empty model output becomes invalid rather than fabricated data", async () => {
+        completeMock.mockResolvedValueOnce({ output: null });
+        const resultNull = await resolveSemanticInput({
+            input: "gibberish 123",
+            schema: { type: "object" },
+            context: { vocabulary: ["One", "Two"] },
+        });
+        expect(resultNull.status).toBe("invalid");
+        expect(resultNull.value).toBeUndefined();
+        completeMock.mockResolvedValueOnce({ output: "" });
+        const resultEmpty = await resolveSemanticInput({
+            input: "something",
+            schema: { type: "string" },
+        });
+        expect(resultEmpty.status).toBe("invalid");
+        expect(resultEmpty.value).toBeUndefined();
+    });
+    it("8. preserveRawInput defaults to false", async () => {
+        completeMock.mockResolvedValueOnce({ output: 42 });
+        const result = await resolveSemanticInput({
+            input: "forty-two",
+            schema: { type: "integer" },
+        });
+        expect(result.status).toBe("resolved");
+        expect(result.value).toBe(42);
+        expect("rawInput" in result).toBe(false);
+    });
+    it("9. preserveRawInput: true returns the original input", async () => {
+        completeMock.mockResolvedValueOnce({ output: 42 });
+        const result = await resolveSemanticInput({
+            input: "  forty-two  ",
+            schema: { type: "integer" },
+            preserveRawInput: true,
+        });
+        expect(result.status).toBe("resolved");
+        expect(result.value).toBe(42);
+        expect(result.rawInput).toBe("  forty-two  ");
+    });
+    it("10. Contextual example resolves through schema/context pipeline without hard-coded replacements", async () => {
+        similarityMock.mockImplementation(async ({ right }) => (right === "May" ? 0.95 : 0.3));
+        rerankMock.mockResolvedValueOnce([12.0, 1.0]);
+        completeMock.mockResolvedValueOnce({ output: "May" });
+        const result = await resolveSemanticInput({
+            input: "23 mage 1994",
+            schema: { type: "string" },
+            context: {
+                field: "Date of Birth",
+                semanticType: "date",
+                vocabulary: ["May", "March"],
+            },
+            preserveRawInput: true,
+        });
+        expect(result.status).toBe("resolved");
+        expect(result.value).toBe("May");
+        expect(result.rawInput).toBe("23 mage 1994");
+        expect(result.candidates[0]?.value).toBe("May");
+    });
+    describe("Edge cases", () => {
+        it("handles empty or whitespace-only input safely", async () => {
+            const emptyResult = await resolveSemanticInput({
+                input: "",
+                schema: { type: "string" },
+            });
+            expect(emptyResult.status).toBe("invalid");
+            expect(emptyResult.value).toBeUndefined();
+            expect(completeMock).not.toHaveBeenCalled();
+            const whitespaceResult = await resolveSemanticInput({
+                input: "    \t\n  ",
+                schema: { type: "string" },
+                preserveRawInput: true,
+            });
+            expect(whitespaceResult.status).toBe("invalid");
+            expect(whitespaceResult.rawInput).toBe("    \t\n  ");
+            expect(completeMock).not.toHaveBeenCalled();
+        });
+        it("handles model exceptions safely", async () => {
+            completeMock.mockRejectedValueOnce(new Error("Needle inference timeout"));
+            const result = await resolveSemanticInput({
+                input: "failing query",
+                schema: { type: "string" },
+            });
+            expect(result.status).toBe("invalid");
+            expect(result.value).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/semantic-input/index.test.js.map

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

package/gutts.manifest.json

@@ -2,7 +2,7 @@
   "$schema": "https://skipo.dev/schemas/gutts-manifest.v1.json",
   "package": "@dinilmusick/gutts",
   "packageType": "global-utility",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "promotion": {
     "eligible": true,
     "scope": "global",
@@ -16,7 +16,8 @@
     "numbers",
     "urls",
     "api",
-    "models"
+    "models",
+    "semantic-input"
   ],
   "exports": [
     "@dinilmusick/gutts/json",
@@ -26,6 +27,7 @@
     "@dinilmusick/gutts/numbers",
     "@dinilmusick/gutts/urls",
     "@dinilmusick/gutts/api",
-    "@dinilmusick/gutts/models"
+    "@dinilmusick/gutts/models",
+    "@dinilmusick/gutts/semantic-input"
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dinilmusick/gutts",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "private": false,
   "description": "Global Utilities for TypeScript applications.",
   "type": "module",
@@ -16,6 +16,7 @@
     "./urls": "./dist/urls/url-concepts.js",
     "./api": "./dist/api/index.js",
     "./models": "./dist/models/index.js",
+    "./semantic-input": "./dist/semantic-input/index.js",
     "./gutts.manifest.json": "./gutts.manifest.json"
   },
   "scripts": {