@dani-builder/agent-contract 0.2.0

package/README.md

@@ -0,0 +1,12 @@
+# @dani-builder/agent-contract
+
+Zero-dependency TypeScript wire contracts for Daniworks Agent clients.
+
+```ts
+import type { ChatRequest, ChatResponse } from "@dani-builder/agent-contract";
+import { parseSseEvent } from "@dani-builder/agent-contract";
+```
+
+The package is safe to import from browser clients: it has no Strapi or plugin
+peer dependency. It defines chat request/response, retrieval citation, and SSE
+event shapes; it does not implement a chat runtime.

package/dist/agent-id.d.ts

@@ -0,0 +1,7 @@
+/** Agent identifiers are issued by the control plane and never edited by hand. */
+export declare const AGENT_ID_PREFIX = "agt_";
+/** Resolves to whichever agent a site configures as its default. */
+export declare const DEFAULT_AGENT_ALIAS = "@default";
+export declare function isAgentId(value: unknown): value is string;
+export declare function isAgentSelector(value: unknown): value is string;
+//# sourceMappingURL=agent-id.d.ts.map

package/dist/agent-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-id.d.ts","sourceRoot":"","sources":["../src/agent-id.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,eAAO,MAAM,eAAe,SAAS,CAAC;AAEtC,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAI9C,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAMzD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE/D"}

package/dist/agent-id.js

@@ -0,0 +1,14 @@
+/** Agent identifiers are issued by the control plane and never edited by hand. */
+export const AGENT_ID_PREFIX = "agt_";
+/** Resolves to whichever agent a site configures as its default. */
+export const DEFAULT_AGENT_ALIAS = "@default";
+const AGENT_ID_BODY = /^[0-9A-Za-z_-]{22}$/;
+export function isAgentId(value) {
+    return (typeof value === "string" &&
+        value.startsWith(AGENT_ID_PREFIX) &&
+        AGENT_ID_BODY.test(value.slice(AGENT_ID_PREFIX.length)));
+}
+export function isAgentSelector(value) {
+    return value === DEFAULT_AGENT_ALIAS || isAgentId(value);
+}
+//# sourceMappingURL=agent-id.js.map

package/dist/agent-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-id.js","sourceRoot":"","sources":["../src/agent-id.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,oEAAoE;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAE9C,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAE5C,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,UAAU,CAAC,eAAe,CAAC;QACjC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CACxD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,KAAK,mBAAmB,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,45 @@
+import type { ResponseExtension } from "./extensions.js";
+import type { ChatContextStatus, CitedSource } from "./sources.js";
+export interface ChatSessionEventData {
+    sessionId: string;
+    agentId: string;
+    contextApplied?: boolean;
+    contextStatus?: ChatContextStatus;
+}
+export interface ChatDoneEventData {
+    sessionId: string;
+    agentId: string;
+    text: string;
+    sources: CitedSource[];
+    extensions: ResponseExtension[];
+    contextApplied?: boolean;
+    contextStatus?: ChatContextStatus;
+}
+export type ChatEvent = {
+    event: "session";
+    data: ChatSessionEventData;
+} | {
+    event: "sources";
+    data: CitedSource[];
+} | {
+    event: "delta";
+    data: {
+        text: string;
+    };
+} | {
+    event: "extension";
+    data: ResponseExtension;
+} | {
+    event: "done";
+    data: ChatDoneEventData;
+} | {
+    event: "error";
+    data: {
+        code: string;
+        message: string;
+    };
+};
+export type ChatEventName = ChatEvent["event"];
+export declare function formatSseEvent(event: ChatEvent): string;
+export declare function parseSseEvent(name: string, data: string): ChatEvent | null;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEnE,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED,MAAM,MAAM,SAAS,GACjB;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAChD;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,WAAW,EAAE,CAAA;CAAE,GACzC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC1C;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC/C;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC1C;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEhE,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;AAE/C,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEvD;AAcD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAgE1E"}

package/dist/events.js

@@ -0,0 +1,83 @@
+import { parseResponseExtension } from "./extensions.js";
+import { parseCitedSources } from "./sources.js";
+export function formatSseEvent(event) {
+    return `event: ${event.event}\ndata: ${JSON.stringify(event.data)}\n\n`;
+}
+function stringValue(value) {
+    return typeof value === "string" ? value : "";
+}
+function contextStatus(value) {
+    return value === "applied" ||
+        value === "quote_unverified" ||
+        value === "unavailable"
+        ? value
+        : undefined;
+}
+export function parseSseEvent(name, data) {
+    let payload;
+    try {
+        payload = JSON.parse(data);
+    }
+    catch {
+        return null;
+    }
+    if (name === "sources")
+        return { event: "sources", data: parseCitedSources(payload) };
+    if (typeof payload !== "object" || payload === null)
+        return null;
+    const record = payload;
+    if (name === "delta")
+        return { event: "delta", data: { text: stringValue(record.text) } };
+    if (name === "error")
+        return {
+            event: "error",
+            data: {
+                code: stringValue(record.code),
+                message: stringValue(record.message),
+            },
+        };
+    if (name === "session") {
+        return {
+            event: "session",
+            data: {
+                sessionId: stringValue(record.sessionId),
+                agentId: stringValue(record.agentId),
+                ...(typeof record.contextApplied === "boolean"
+                    ? { contextApplied: record.contextApplied }
+                    : {}),
+                ...(contextStatus(record.contextStatus)
+                    ? { contextStatus: contextStatus(record.contextStatus) }
+                    : {}),
+            },
+        };
+    }
+    if (name === "extension") {
+        const extension = parseResponseExtension(record);
+        return extension ? { event: "extension", data: extension } : null;
+    }
+    if (name === "done") {
+        return {
+            event: "done",
+            data: {
+                sessionId: stringValue(record.sessionId),
+                agentId: stringValue(record.agentId),
+                text: stringValue(record.text),
+                sources: parseCitedSources(record.sources),
+                extensions: Array.isArray(record.extensions)
+                    ? record.extensions.flatMap((extension) => {
+                        const parsed = parseResponseExtension(extension);
+                        return parsed ? [parsed] : [];
+                    })
+                    : [],
+                ...(typeof record.contextApplied === "boolean"
+                    ? { contextApplied: record.contextApplied }
+                    : {}),
+                ...(contextStatus(record.contextStatus)
+                    ? { contextStatus: contextStatus(record.contextStatus) }
+                    : {}),
+            },
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/extensions.d.ts

@@ -0,0 +1,22 @@
+export interface FollowUpQuestionsExtension {
+    type: "follow_up_questions";
+    version: 1;
+    payload: {
+        questions: string[];
+    };
+}
+export interface GenericBlockItem {
+    label: string;
+    value: string;
+}
+export interface GenericBlockExtension {
+    type: "generic_block";
+    version: 1;
+    payload: {
+        title?: string;
+        items: GenericBlockItem[];
+    };
+}
+export type ResponseExtension = FollowUpQuestionsExtension | GenericBlockExtension;
+export declare function parseResponseExtension(value: unknown): ResponseExtension | null;
+//# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,gBAAgB,EAAE,CAAA;KAAE,CAAC;CACxD;AAED,MAAM,MAAM,iBAAiB,GAC3B,0BAA0B,GAAG,qBAAqB,CAAC;AAQrD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,GACb,iBAAiB,GAAG,IAAI,CAuC1B"}

package/dist/extensions.js

@@ -0,0 +1,42 @@
+function isStringArray(value) {
+    return (Array.isArray(value) && value.every((item) => typeof item === "string"));
+}
+export function parseResponseExtension(value) {
+    if (typeof value !== "object" || value === null)
+        return null;
+    const record = value;
+    if (record.type === "follow_up_questions" && record.version === 1) {
+        const payload = record.payload;
+        if (typeof payload !== "object" || payload === null)
+            return null;
+        const questions = payload.questions;
+        return isStringArray(questions)
+            ? { type: "follow_up_questions", version: 1, payload: { questions } }
+            : null;
+    }
+    if (record.type === "generic_block" && record.version === 1) {
+        const payload = record.payload;
+        if (typeof payload !== "object" || payload === null)
+            return null;
+        const rawPayload = payload;
+        if (!Array.isArray(rawPayload.items) ||
+            !rawPayload.items.every((item) => typeof item === "object" &&
+                item !== null &&
+                typeof item.label === "string" &&
+                typeof item.value === "string")) {
+            return null;
+        }
+        return {
+            type: "generic_block",
+            version: 1,
+            payload: {
+                ...(typeof rawPayload.title === "string"
+                    ? { title: rawPayload.title }
+                    : {}),
+                items: rawPayload.items,
+            },
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=extensions.js.map

package/dist/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAoBA,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CACxE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,IAAI,MAAM,CAAC,IAAI,KAAK,qBAAqB,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QAClE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACjE,MAAM,SAAS,GAAI,OAAmC,CAAC,SAAS,CAAC;QACjE,OAAO,aAAa,CAAC,SAAS,CAAC;YAC7B,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE;YACrE,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,eAAe,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACjE,MAAM,UAAU,GAAG,OAAkC,CAAC;QACtD,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC;YAChC,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CACrB,CAAC,IAAI,EAAE,EAAE,CACP,OAAO,IAAI,KAAK,QAAQ;gBACxB,IAAI,KAAK,IAAI;gBACb,OAAQ,IAAgC,CAAC,KAAK,KAAK,QAAQ;gBAC3D,OAAQ,IAAgC,CAAC,KAAK,KAAK,QAAQ,CAC9D,EACD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,CAAC;YACV,OAAO,EAAE;gBACP,GAAG,CAAC,OAAO,UAAU,CAAC,KAAK,KAAK,QAAQ;oBACtC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE;oBAC7B,CAAC,CAAC,EAAE,CAAC;gBACP,KAAK,EAAE,UAAU,CAAC,KAA2B;aAC9C;SACF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { AGENT_ID_PREFIX, DEFAULT_AGENT_ALIAS, isAgentId, isAgentSelector, } from "./agent-id.js";
+export { formatSseEvent, parseSseEvent } from "./events.js";
+export { parseCitedSource, parseCitedSources } from "./sources.js";
+export type { ChatEvent, ChatEventName, ChatDoneEventData, ChatSessionEventData, } from "./events.js";
+export type { FollowUpQuestionsExtension, GenericBlockExtension, GenericBlockItem, ResponseExtension, } from "./extensions.js";
+export type { AgentPublicProfile, AgentRetrievalConfig, ChatRequest, ChatResponse, ConversationHistoryMessage, PublicAgentSummary, } from "./public-api.js";
+export type { ChatContextStatus, CitedSource, StoredContext, StoredContextQuote, } from "./sources.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,EACL,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EACV,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { AGENT_ID_PREFIX, DEFAULT_AGENT_ALIAS, isAgentId, isAgentSelector, } from "./agent-id.js";
+export { formatSseEvent, parseSseEvent } from "./events.js";
+export { parseCitedSource, parseCitedSources } from "./sources.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":"AAAA,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/public-api.d.ts

@@ -0,0 +1,52 @@
+import type { ResponseExtension } from "./extensions.js";
+import type { CitedSource, StoredContext } from "./sources.js";
+export interface AgentPublicProfile {
+    displayName?: string;
+    description?: string;
+    avatar?: {
+        url: string;
+        alternativeText?: string;
+    };
+}
+export interface PublicAgentSummary extends AgentPublicProfile {
+    agentId: string;
+}
+export interface AgentRetrievalConfig {
+    maxMessageLength: number;
+    maxQuoteLength: number;
+    topK: number;
+    anchorTopK: number;
+    maxSourceGroups: number;
+    sourceUids: string[];
+}
+export interface ChatRequest {
+    message: string;
+    agentId?: string;
+    sessionId?: string;
+    locale?: string;
+    context?: {
+        sourceUid: string;
+        documentId: string;
+        quote?: {
+            text: string;
+        };
+    };
+}
+export interface ChatResponse {
+    sessionId: string;
+    agentId: string;
+    text: string;
+    sources: CitedSource[];
+    extensions: ResponseExtension[];
+    contextApplied?: boolean;
+    contextStatus?: "applied" | "quote_unverified" | "unavailable";
+}
+export interface ConversationHistoryMessage {
+    role: "user" | "assistant";
+    content: string;
+    context?: StoredContext | null;
+    retrieved?: CitedSource[];
+    extensions?: ResponseExtension[];
+    createdAt: string | null;
+}
+//# sourceMappingURL=public-api.d.ts.map

package/dist/public-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAED,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CAC/E;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,SAAS,GAAG,kBAAkB,GAAG,aAAa,CAAC;CAChE;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACjC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B"}

package/dist/public-api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=public-api.js.map

package/dist/public-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":""}

package/dist/sources.d.ts

@@ -0,0 +1,28 @@
+export interface CitedSource {
+    n: number;
+    sourceUid: string;
+    documentId: string;
+    title: string;
+    description?: string;
+    url?: string;
+    excerpts: string[];
+    chunkIndexes: number[];
+    score: number;
+}
+export interface StoredContextQuote {
+    verified: boolean;
+    text: string;
+}
+export interface StoredContext {
+    applied: boolean;
+    sourceUid?: string;
+    documentId?: string;
+    title?: string;
+    url?: string;
+    quote?: StoredContextQuote;
+    reason?: "source_disabled" | "not_indexed" | "not_retrieved";
+}
+export type ChatContextStatus = "applied" | "quote_unverified" | "unavailable";
+export declare function parseCitedSource(value: unknown): CitedSource | null;
+export declare function parseCitedSources(value: unknown): CitedSource[];
+//# sourceMappingURL=sources.d.ts.map

package/dist/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../src/sources.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,MAAM,CAAC,EAAE,iBAAiB,GAAG,aAAa,GAAG,eAAe,CAAC;CAC9D;AAED,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,kBAAkB,GAAG,aAAa,CAAC;AAmB/E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CA+BnE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,EAAE,CAM/D"}

package/dist/sources.js

@@ -0,0 +1,55 @@
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function safeUrl(value) {
+    if (!isNonEmptyString(value))
+        return undefined;
+    const url = value.trim();
+    const scheme = /^[a-z][a-z\d+.-]*:/i
+        .exec(url.replace(/[\u0000-\u001F\u007F\s]/g, ""))?.[0]
+        .toLowerCase();
+    return scheme === "javascript:" ||
+        scheme === "data:" ||
+        scheme === "vbscript:"
+        ? undefined
+        : url;
+}
+export function parseCitedSource(value) {
+    if (typeof value !== "object" || value === null)
+        return null;
+    const raw = value;
+    if (!Number.isInteger(raw.n) || typeof raw.n !== "number" || raw.n < 1)
+        return null;
+    if (!isNonEmptyString(raw.sourceUid) || !isNonEmptyString(raw.documentId))
+        return null;
+    if (typeof raw.title !== "string")
+        return null;
+    return {
+        n: raw.n,
+        sourceUid: raw.sourceUid,
+        documentId: raw.documentId,
+        title: raw.title,
+        ...(isNonEmptyString(raw.description)
+            ? { description: raw.description }
+            : {}),
+        ...(safeUrl(raw.url) ? { url: safeUrl(raw.url) } : {}),
+        excerpts: Array.isArray(raw.excerpts)
+            ? raw.excerpts.filter(isNonEmptyString)
+            : [],
+        chunkIndexes: Array.isArray(raw.chunkIndexes)
+            ? raw.chunkIndexes.filter((index) => Number.isInteger(index))
+            : [],
+        score: typeof raw.score === "number" && Number.isFinite(raw.score)
+            ? raw.score
+            : 0,
+    };
+}
+export function parseCitedSources(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.flatMap((entry) => {
+        const source = parseCitedSource(entry);
+        return source ? [source] : [];
+    });
+}
+//# sourceMappingURL=sources.js.map

package/dist/sources.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@dani-builder/agent-contract",
+  "version": "0.2.0",
+  "description": "Zero-dependency wire contracts for Daniworks Agent clients.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "scripts": {
+    "build": "tsc",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}