@indexnetwork/protocol 1.5.1 → 1.6.0-rc.146.1

package/dist/shared/interfaces/questioner.interface.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Protocol-level persistence contract for structured questions generated by
+ * the QuestionerAgent. Implementations live in the backend and are injected
+ * into ProtocolDeps.
+ */
+import type { Question, QuestionMode, QuestionStrategy, QuestionDetection, QuestionActor, QuestionAnswer } from "../schemas/question.schema.js";
+/** Shape accepted by `persist()` — everything needed to insert a question row. */
+export interface PersistableQuestion {
+    detection: QuestionDetection;
+    actors: QuestionActor[];
+    payload: Question;
+    strategy: QuestionStrategy;
+}
+/** Shape returned by `findPending()` — a persisted question with its DB id and status. */
+export interface PersistedQuestion {
+    id: string;
+    detection: QuestionDetection;
+    actors: QuestionActor[];
+    payload: Question;
+    status: "pending" | "answered" | "dismissed";
+    answer: QuestionAnswer | null;
+    createdAt: string;
+}
+/** Optional filters for `findPending()`. */
+export interface QuestionFilters {
+    mode?: QuestionMode;
+    sourceType?: string;
+    sourceId?: string;
+}
+export interface QuestionerDatabase {
+    /** Persist a batch of generated questions (up to 3 per generation). */
+    persist(questions: PersistableQuestion[]): Promise<void>;
+    /** Find pending questions for a user, optionally filtered by mode/source. */
+    findPending(userId: string, filters?: QuestionFilters): Promise<PersistedQuestion[]>;
+    /** Record an answer for a question. Sets status to "answered". */
+    answer(questionId: string, answer: QuestionAnswer): Promise<void>;
+    /** Dismiss a question. Sets status to "dismissed". */
+    dismiss(questionId: string): Promise<void>;
+}
+//# sourceMappingURL=questioner.interface.d.ts.map

package/dist/shared/interfaces/questioner.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"questioner.interface.d.ts","sourceRoot":"","sources":["../../../src/shared/interfaces/questioner.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACf,MAAM,+BAA+B,CAAC;AAEvC,kFAAkF;AAClF,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,OAAO,EAAE,QAAQ,CAAC;IAClB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,0FAA0F;AAC1F,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,iBAAiB,CAAC;IAC7B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,OAAO,EAAE,QAAQ,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,OAAO,CAAC,SAAS,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD,6EAA6E;IAC7E,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAErF,kEAAkE;IAClE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE,sDAAsD;IACtD,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C"}

package/dist/shared/interfaces/questioner.interface.js

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

package/dist/shared/interfaces/questioner.interface.js.map

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

package/dist/shared/network/metadata.renderer.d.ts

@@ -0,0 +1,15 @@
+interface NetworkForRendering {
+    type: string;
+    title: string;
+    prompt?: string | null;
+    metadata: Record<string, unknown>;
+}
+/**
+ * Render a network's metadata as structured markdown for LLM context.
+ *
+ * @param network - The network to render, with type, title, optional prompt, and metadata.
+ * @returns Markdown string suitable for injection into an LLM prompt.
+ */
+export declare function renderNetworkContext(network: NetworkForRendering): string;
+export {};
+//# sourceMappingURL=metadata.renderer.d.ts.map

package/dist/shared/network/metadata.renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.renderer.d.ts","sourceRoot":"","sources":["../../../src/shared/network/metadata.renderer.ts"],"names":[],"mappings":"AAAA,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAmBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAQzE"}

package/dist/shared/network/metadata.renderer.js

@@ -0,0 +1,104 @@
+/**
+ * Render a network's metadata as structured markdown for LLM context.
+ *
+ * @param network - The network to render, with type, title, optional prompt, and metadata.
+ * @returns Markdown string suitable for injection into an LLM prompt.
+ */
+export function renderNetworkContext(network) {
+    switch (network.type) {
+        case 'event':
+            return renderEventNetwork(network);
+        case 'community':
+        default:
+            return renderCommunityNetwork(network);
+    }
+}
+function renderCommunityNetwork(network) {
+    const lines = [`## ${network.title}`];
+    if (network.prompt) {
+        lines.push('', network.prompt);
+    }
+    return lines.join('\n');
+}
+function renderEventNetwork(network) {
+    const meta = network.metadata;
+    const startDate = typeof meta.startDate === 'string' ? meta.startDate : undefined;
+    const endDate = typeof meta.endDate === 'string' ? meta.endDate : undefined;
+    const location = typeof meta.location === 'string' ? meta.location : undefined;
+    const timezone = typeof meta.timezone === 'string' ? meta.timezone : undefined;
+    const themes = Array.isArray(meta.themes) ? meta.themes.filter((t) => typeof t === 'string') : [];
+    const events = Array.isArray(meta.events) ? normalizeEvents(meta.events) : [];
+    const lines = [`## ${network.title}`];
+    if (network.prompt) {
+        lines.push('', network.prompt);
+    }
+    lines.push('');
+    lines.push('- **Type:** Event');
+    const dateRange = startDate && endDate ? formatDateRange(startDate, endDate) : undefined;
+    if (dateRange) {
+        lines.push(`- **Dates:** ${dateRange}`);
+    }
+    if (location) {
+        lines.push(`- **Location:** ${location}`);
+    }
+    if (timezone) {
+        lines.push(`- **Timezone:** ${timezone}`);
+    }
+    if (themes.length > 0) {
+        lines.push(`- **Themes:** ${themes.join(', ')}`);
+    }
+    lines.push('');
+    const upcoming = getUpcomingEvents(events, 7);
+    if (upcoming.length === 0) {
+        lines.push('No upcoming events in the next 7 days.');
+    }
+    else {
+        lines.push('### Upcoming Events (next 7 days)');
+        lines.push('| Time | Event | Location |');
+        lines.push('|------|-------|----------|');
+        for (const evt of upcoming) {
+            const time = formatEventTime(evt.startTime);
+            const loc = escapeTableCell(evt.location ?? '');
+            const title = escapeTableCell(evt.title);
+            lines.push(`| ${time} | ${title} | ${loc} |`);
+        }
+    }
+    return lines.join('\n');
+}
+function formatDateRange(start, end) {
+    const s = new Date(start);
+    const e = new Date(end);
+    if (isNaN(s.getTime()) || isNaN(e.getTime()))
+        return undefined;
+    const opts = { month: 'long', day: 'numeric', year: 'numeric', timeZone: 'UTC' };
+    return `${s.toLocaleDateString('en-US', opts)} – ${e.toLocaleDateString('en-US', opts)}`;
+}
+function formatEventTime(iso) {
+    const d = new Date(iso);
+    if (isNaN(d.getTime()))
+        return iso;
+    return d.toLocaleDateString('en-US', { month: 'short', day: 'numeric', timeZone: 'UTC' }) +
+        ', ' +
+        d.toLocaleTimeString('en-US', { hour: 'numeric', minute: '2-digit', timeZone: 'UTC' });
+}
+function escapeTableCell(value) {
+    return value.replace(/\|/g, '\\|').replace(/\n/g, ' ');
+}
+function normalizeEvents(raw) {
+    return raw.filter((e) => {
+        if (typeof e !== 'object' || e === null)
+            return false;
+        const obj = e;
+        return typeof obj.title === 'string' && typeof obj.startTime === 'string' && typeof obj.endTime === 'string';
+    });
+}
+function getUpcomingEvents(events, windowDays) {
+    const now = Date.now();
+    const windowEnd = now + windowDays * 24 * 60 * 60 * 1000;
+    return events
+        .map((e) => ({ e, t: new Date(e.startTime).getTime() }))
+        .filter(({ t }) => !isNaN(t) && t >= now && t <= windowEnd)
+        .sort((a, b) => a.t - b.t)
+        .map(({ e }) => e);
+}
+//# sourceMappingURL=metadata.renderer.js.map

package/dist/shared/network/metadata.renderer.js.map

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

package/dist/shared/schemas/question.schema.d.ts

@@ -179,4 +179,69 @@ export interface QuestionGenerationResult {
     questions: Question[];
     strategies: QuestionStrategy[];
 }
+export declare const QuestionModeSchema: z.ZodEnum<["discovery", "intent", "profile", "negotiation"]>;
+export declare const QuestionDetectionSchema: z.ZodObject<{
+    /** Which preset mode generated this question. */
+    mode: z.ZodEnum<["discovery", "intent", "profile", "negotiation"]>;
+    /** Entity type that triggered generation (e.g. "opportunity", "intent", "profile"). */
+    sourceType: z.ZodString;
+    /** ID of the triggering entity. */
+    sourceId: z.ZodString;
+    /** Optional intent ID that was the root cause. */
+    triggeredBy: z.ZodOptional<z.ZodString>;
+    /** ISO-8601 timestamp of generation. */
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sourceType: string;
+    sourceId: string;
+    mode: "profile" | "intent" | "discovery" | "negotiation";
+    timestamp: string;
+    triggeredBy?: string | undefined;
+}, {
+    sourceType: string;
+    sourceId: string;
+    mode: "profile" | "intent" | "discovery" | "negotiation";
+    timestamp: string;
+    triggeredBy?: string | undefined;
+}>;
+export declare const QuestionActorSchema: z.ZodObject<{
+    /** The user this question is for. */
+    userId: z.ZodString;
+    /** Optional network context. */
+    networkId: z.ZodOptional<z.ZodString>;
+    /** Actor's role in the question — currently always "subject". */
+    role: z.ZodLiteral<"subject">;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+    role: "subject";
+    networkId?: string | undefined;
+}, {
+    userId: string;
+    role: "subject";
+    networkId?: string | undefined;
+}>;
+export declare const QuestionAnswerSchema: z.ZodObject<{
+    /** Option labels the user selected. */
+    selectedOptions: z.ZodArray<z.ZodString, "many">;
+    /** Free-text input when the user chose "Other" or elaborated. */
+    freeText: z.ZodOptional<z.ZodString>;
+    /** User ID of the answerer. */
+    answeredBy: z.ZodString;
+    /** ISO-8601 timestamp of when the answer was submitted. */
+    answeredAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    selectedOptions: string[];
+    answeredBy: string;
+    answeredAt: string;
+    freeText?: string | undefined;
+}, {
+    selectedOptions: string[];
+    answeredBy: string;
+    answeredAt: string;
+    freeText?: string | undefined;
+}>;
+export type QuestionMode = z.infer<typeof QuestionModeSchema>;
+export type QuestionDetection = z.infer<typeof QuestionDetectionSchema>;
+export type QuestionActor = z.infer<typeof QuestionActorSchema>;
+export type QuestionAnswer = z.infer<typeof QuestionAnswerSchema>;
 //# sourceMappingURL=question.schema.d.ts.map

package/dist/shared/schemas/question.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"question.schema.d.ts","sourceRoot":"","sources":["../../../src/shared/schemas/question.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;IAC/B,+EAA+E;;IAE/E,iFAAiF;;;;;;;;EAEjF,CAAC;AAEH,eAAO,MAAM,cAAc;IACzB,+EAA+E;;IAE/E,yDAAyD;;IAEzD,6EAA6E;;QAX7E,+EAA+E;;QAE/E,iFAAiF;;;;;;;;;IAWjF,0EAA0E;;;;;;;;;;;;;;;;;;EAE1E,CAAC;AAEH,eAAO,MAAM,sBAAsB,oIAMjC,CAAC;AAEH,eAAO,MAAM,0BAA0B;IAlBrC,+EAA+E;;IAE/E,yDAAyD;;IAEzD,6EAA6E;;QAX7E,+EAA+E;;QAE/E,iFAAiF;;;;;;;;;IAWjF,0EAA0E;;;;;;;;;;;;;;;;;;;;;;EAc1E,CAAC;AAEH,eAAO,MAAM,+BAA+B;;QAtB1C,+EAA+E;;QAE/E,yDAAyD;;QAEzD,6EAA6E;;YAX7E,+EAA+E;;YAE/E,iFAAiF;;;;;;;;;QAWjF,0EAA0E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB1E,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC"}
+{"version":3,"file":"question.schema.d.ts","sourceRoot":"","sources":["../../../src/shared/schemas/question.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;IAC/B,+EAA+E;;IAE/E,iFAAiF;;;;;;;;EAEjF,CAAC;AAEH,eAAO,MAAM,cAAc;IACzB,+EAA+E;;IAE/E,yDAAyD;;IAEzD,6EAA6E;;QAX7E,+EAA+E;;QAE/E,iFAAiF;;;;;;;;;IAWjF,0EAA0E;;;;;;;;;;;;;;;;;;EAE1E,CAAC;AAEH,eAAO,MAAM,sBAAsB,oIAMjC,CAAC;AAEH,eAAO,MAAM,0BAA0B;IAlBrC,+EAA+E;;IAE/E,yDAAyD;;IAEzD,6EAA6E;;QAX7E,+EAA+E;;QAE/E,iFAAiF;;;;;;;;;IAWjF,0EAA0E;;;;;;;;;;;;;;;;;;;;;;EAc1E,CAAC;AAEH,eAAO,MAAM,+BAA+B;;QAtB1C,+EAA+E;;QAE/E,yDAAyD;;QAEzD,6EAA6E;;YAX7E,+EAA+E;;YAE/E,iFAAiF;;;;;;;;;QAWjF,0EAA0E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB1E,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAID,eAAO,MAAM,kBAAkB,8DAK7B,CAAC;AAEH,eAAO,MAAM,uBAAuB;IAClC,iDAAiD;;IAEjD,uFAAuF;;IAEvF,mCAAmC;;IAEnC,kDAAkD;;IAElD,wCAAwC;;;;;;;;;;;;;;EAExC,CAAC;AAEH,eAAO,MAAM,mBAAmB;IAC9B,qCAAqC;;IAErC,gCAAgC;;IAEhC,iEAAiE;;;;;;;;;;EAEjE,CAAC;AAEH,eAAO,MAAM,oBAAoB;IAC/B,uCAAuC;;IAEvC,iEAAiE;;IAEjE,+BAA+B;;IAE/B,2DAA2D;;;;;;;;;;;;EAE3D,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/shared/schemas/question.schema.js

@@ -38,4 +38,41 @@ export const QuestionWithStrategySchema = QuestionSchema.extend({
 export const QuestionGeneratorResponseSchema = z.object({
     questions: z.array(QuestionWithStrategySchema).max(3),
 });
+// ─── Persistence types (opportunity-style composable jsonb) ──────────────────
+export const QuestionModeSchema = z.enum([
+    "discovery",
+    "intent",
+    "profile",
+    "negotiation",
+]);
+export const QuestionDetectionSchema = z.object({
+    /** Which preset mode generated this question. */
+    mode: QuestionModeSchema,
+    /** Entity type that triggered generation (e.g. "opportunity", "intent", "profile"). */
+    sourceType: z.string().min(1),
+    /** ID of the triggering entity. */
+    sourceId: z.string().min(1),
+    /** Optional intent ID that was the root cause. */
+    triggeredBy: z.string().optional(),
+    /** ISO-8601 timestamp of generation. */
+    timestamp: z.string().min(1),
+});
+export const QuestionActorSchema = z.object({
+    /** The user this question is for. */
+    userId: z.string().min(1),
+    /** Optional network context. */
+    networkId: z.string().optional(),
+    /** Actor's role in the question — currently always "subject". */
+    role: z.literal("subject"),
+});
+export const QuestionAnswerSchema = z.object({
+    /** Option labels the user selected. */
+    selectedOptions: z.array(z.string()),
+    /** Free-text input when the user chose "Other" or elaborated. */
+    freeText: z.string().optional(),
+    /** User ID of the answerer. */
+    answeredBy: z.string().min(1),
+    /** ISO-8601 timestamp of when the answer was submitted. */
+    answeredAt: z.string().min(1),
+});
 //# sourceMappingURL=question.schema.js.map

package/dist/shared/schemas/question.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"question.schema.js","sourceRoot":"","sources":["../../../src/shared/schemas/question.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,+EAA+E;IAC/E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACjC,iFAAiF;IACjF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CACxC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,+EAA+E;IAC/E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAChC,yDAAyD;IACzD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAClC,6EAA6E;IAC7E,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,0EAA0E;IAC1E,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;CACzB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,eAAe;IACf,wBAAwB;IACxB,sBAAsB;IACtB,oBAAoB;IACpB,4BAA4B;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,cAAc,CAAC,MAAM,CAAC;IAC9D,QAAQ,EAAE,sBAAsB;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACtD,CAAC,CAAC"}
+{"version":3,"file":"question.schema.js","sourceRoot":"","sources":["../../../src/shared/schemas/question.schema.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "1.5.1",
+  "version": "1.6.0-rc.146.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",