veryfront 0.1.232 → 0.1.233

package/esm/deno.d.ts

@@ -17,6 +17,7 @@ declare namespace _default {
         "./markdown": string;
         "./mdx": string;
         "./agent": string;
+        "./agent/conversation-bootstrap": string;
         "./agent/durable": string;
         "./channels/control-plane": string;
         "./channels/invoke": string;

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.232",
+    "version": "0.1.233",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "workspace": [
@@ -30,6 +30,7 @@ export default {
         "./markdown": "./src/markdown/index.ts",
         "./mdx": "./src/mdx/index.ts",
         "./agent": "./src/agent/index.ts",
+        "./agent/conversation-bootstrap": "./src/agent/conversation-bootstrap.ts",
         "./agent/durable": "./src/agent/durable.ts",
         "./channels/control-plane": "./src/channels/control-plane.ts",
         "./channels/invoke": "./src/channels/invoke.ts",

package/esm/src/agent/conversation-bootstrap.d.ts

@@ -0,0 +1,61 @@
+import "../../_dnt.polyfills.js";
+import { z } from "zod";
+import { type ConversationRunProjection } from "./durable.js";
+export declare const ConversationRecordSchema: z.ZodPipe<z.ZodObject<{
+    id: z.ZodString;
+    projectId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    project_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>, z.ZodTransform<{
+    id: string;
+    projectId: string | null;
+}, {
+    [x: string]: unknown;
+    id: string;
+    projectId?: string | null | undefined;
+    project_id?: string | null | undefined;
+}>>;
+export declare const ConversationMessageRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export type ConversationRecord = z.infer<typeof ConversationRecordSchema>;
+export type ConversationMessageRecord = z.infer<typeof ConversationMessageRecordSchema>;
+export declare function fetchConversationRecord(input: {
+    authToken: string;
+    apiUrl: string;
+    conversationId: string;
+}): Promise<ConversationRecord>;
+export declare function ensureConversationProjectLink(input: {
+    authToken: string;
+    apiUrl: string;
+    conversationId: string;
+    projectId: string;
+}): Promise<void>;
+export declare function createConversationRecord(input: {
+    authToken: string;
+    apiUrl: string;
+    body: unknown;
+}): Promise<ConversationRecord>;
+export declare function createConversationMessage(input: {
+    authToken: string;
+    apiUrl: string;
+    conversationId: string;
+    body: unknown;
+}): Promise<ConversationMessageRecord>;
+export interface BootstrapConversationAgentRunResult {
+    conversation: ConversationRecord;
+    message: ConversationMessageRecord;
+    run: ConversationRunProjection;
+}
+export declare function bootstrapConversationAgentRun(input: {
+    authToken: string;
+    apiUrl: string;
+    parentConversationId?: string;
+    ensureProjectId?: string;
+    conversationBody: unknown;
+    handoffMessageBody: unknown;
+    runId?: string;
+    agentId: string;
+    projectId?: string | null;
+    branchId?: string | null;
+}): Promise<BootstrapConversationAgentRunResult>;
+//# sourceMappingURL=conversation-bootstrap.d.ts.map

package/esm/src/agent/conversation-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-bootstrap.d.ts","sourceRoot":"","sources":["../../../src/src/agent/conversation-bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AAEjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,yBAAyB,EAA8B,MAAM,cAAc,CAAC;AAI1F,eAAO,MAAM,wBAAwB;;;;;;;;;;;;GAUhC,CAAC;AAEN,eAAO,MAAM,+BAA+B;;iBAE1C,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAmDxF,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAO9B;AAED,wBAAsB,6BAA6B,CAAC,KAAK,EAAE;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhB;AAED,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAS9B;AAED,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,yBAAyB,CAAC,CASrC;AAED,MAAM,WAAW,mCAAmC;IAClD,YAAY,EAAE,kBAAkB,CAAC;IACjC,OAAO,EAAE,yBAAyB,CAAC;IACnC,GAAG,EAAE,yBAAyB,CAAC;CAChC;AAED,wBAAsB,6BAA6B,CAAC,KAAK,EAAE;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,OAAO,CAAC,mCAAmC,CAAC,CAiC/C"}

package/esm/src/agent/conversation-bootstrap.js

@@ -0,0 +1,131 @@
+import "../../_dnt.polyfills.js";
+import * as dntShim from "../../_dnt.shims.js";
+import { z } from "zod";
+import { createConversationAgentRun } from "./durable.js";
+const CONVERSATION_API_TIMEOUT_MS = 15_000;
+export const ConversationRecordSchema = z
+    .object({
+    id: z.string(),
+    projectId: z.string().nullable().optional(),
+    project_id: z.string().nullable().optional(),
+})
+    .passthrough()
+    .transform((data) => ({
+    id: data.id,
+    projectId: data.projectId ?? data.project_id ?? null,
+}));
+export const ConversationMessageRecordSchema = z.object({
+    id: z.string().uuid(),
+});
+async function controlPlaneJson(input) {
+    const controller = new AbortController();
+    const timeout = dntShim.setTimeout(() => controller.abort(), CONVERSATION_API_TIMEOUT_MS);
+    let response;
+    try {
+        response = await fetch(input.url, {
+            method: input.method ?? "GET",
+            headers: {
+                Authorization: `Bearer ${input.authToken}`,
+                "Content-Type": "application/json",
+            },
+            ...(input.body !== undefined ? { body: JSON.stringify(input.body) } : {}),
+            signal: controller.signal,
+        });
+    }
+    catch (error) {
+        if (error instanceof DOMException && error.name === "AbortError") {
+            throw new Error(`${input.operation} timed out after ${CONVERSATION_API_TIMEOUT_MS}ms`);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+    if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        throw new Error(`${input.operation} failed (${response.status}): ${body || response.statusText}`);
+    }
+    return input.responseSchema.parse(await response.json());
+}
+function buildConversationPath(apiUrl, conversationId) {
+    return `${apiUrl}/conversations/${conversationId}`;
+}
+function buildConversationMessagesPath(apiUrl, conversationId) {
+    return `${buildConversationPath(apiUrl, conversationId)}/messages`;
+}
+export async function fetchConversationRecord(input) {
+    return controlPlaneJson({
+        authToken: input.authToken,
+        url: buildConversationPath(input.apiUrl, input.conversationId),
+        responseSchema: ConversationRecordSchema,
+        operation: "Fetch conversation",
+    });
+}
+export async function ensureConversationProjectLink(input) {
+    const conversation = await fetchConversationRecord(input);
+    if (conversation.projectId === input.projectId)
+        return;
+    if (conversation.projectId !== null) {
+        throw new Error(`Conversation ${input.conversationId} is already linked to a different project (${conversation.projectId})`);
+    }
+    await controlPlaneJson({
+        authToken: input.authToken,
+        url: buildConversationPath(input.apiUrl, input.conversationId),
+        method: "PATCH",
+        body: { project_id: input.projectId },
+        responseSchema: ConversationRecordSchema,
+        operation: "Link conversation to project",
+    });
+}
+export async function createConversationRecord(input) {
+    return controlPlaneJson({
+        authToken: input.authToken,
+        url: `${input.apiUrl}/conversations`,
+        method: "POST",
+        body: input.body,
+        responseSchema: ConversationRecordSchema,
+        operation: "Create conversation",
+    });
+}
+export async function createConversationMessage(input) {
+    return controlPlaneJson({
+        authToken: input.authToken,
+        url: buildConversationMessagesPath(input.apiUrl, input.conversationId),
+        method: "POST",
+        body: input.body,
+        responseSchema: ConversationMessageRecordSchema,
+        operation: "Create conversation message",
+    });
+}
+export async function bootstrapConversationAgentRun(input) {
+    if (input.parentConversationId && input.ensureProjectId) {
+        await ensureConversationProjectLink({
+            authToken: input.authToken,
+            apiUrl: input.apiUrl,
+            conversationId: input.parentConversationId,
+            projectId: input.ensureProjectId,
+        });
+    }
+    const conversation = await createConversationRecord({
+        authToken: input.authToken,
+        apiUrl: input.apiUrl,
+        body: input.conversationBody,
+    });
+    const effectiveProjectId = input.projectId ?? conversation.projectId;
+    const message = await createConversationMessage({
+        authToken: input.authToken,
+        apiUrl: input.apiUrl,
+        conversationId: conversation.id,
+        body: input.handoffMessageBody,
+    });
+    const run = await createConversationAgentRun({
+        authToken: input.authToken,
+        apiUrl: input.apiUrl,
+        conversationId: conversation.id,
+        runId: input.runId,
+        agentId: input.agentId,
+        projectId: effectiveProjectId,
+        branchId: input.branchId,
+    });
+    return { conversation, message, run };
+}

package/esm/src/agent/index.d.ts

@@ -89,6 +89,7 @@ export { type AgUiRuntimeContextItem, AgUiRuntimeContextItemSchema, type AgUiRun
 export { normalizeAgUiRuntimeMessages } from "./ag-ui-runtime-support.js";
 export { type AgUiBrowserEncodedEvent, type AgUiBrowserEncoderState, type AgUiBrowserRunFinishedMetadata, type AgUiRuntimeStreamEvent, buildAgUiBrowserFinalizeResponse, createAgUiBrowserEncoderState, finalizeAgUiBrowserEvents, mapRuntimeStreamEventToAgUiBrowserEvents, } from "./ag-ui-browser-encoder.js";
 export { type AgUiBrowserResponseEncoder, type AgUiBrowserResponseExecution, type AgUiBrowserResponseRequestState, createAgUiBrowserResponseStream, type CreateAgUiBrowserResponseStreamInput, } from "./ag-ui-browser-response-stream.js";
+export { bootstrapConversationAgentRun, type BootstrapConversationAgentRunResult, type ConversationMessageRecord, ConversationMessageRecordSchema, type ConversationRecord, ConversationRecordSchema, createConversationMessage, createConversationRecord, ensureConversationProjectLink, fetchConversationRecord, } from "./conversation-bootstrap.js";
 export { CompleteConversationRunResponseSchema, type ConversationAgentRunUsage, type ConversationRunProjection, ConversationRunProjectionSchema, type ConversationRunTargets, ConversationRunTargetsSchema, createConversationAgentRun, finalizeConversationAgentRun, resolveConversationRunTargets, } from "./durable.js";
 export { type HostedChildLifecycleAdapter, type HostedChildLifecycleRunnerOptions, type HostedChildLifecycleRunResult, type HostedChildLifecycleTerminalState, runHostedChildLifecycle, } from "./hosted-child-lifecycle.js";
 export { type HostedLifecycleAdapter, type HostedLifecycleExecution, type HostedLifecycleRunnerOptions, type HostedLifecycleRunResult, type HostedLifecycleTerminalState, runHostedLifecycle, } from "./hosted-lifecycle.js";

package/esm/src/agent/index.d.ts.map

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

package/esm/src/agent/index.js

@@ -88,6 +88,7 @@ export { AgUiRuntimeContextItemSchema, AgUiRuntimeInjectedToolSchema, AgUiRuntim
 export { normalizeAgUiRuntimeMessages } from "./ag-ui-runtime-support.js";
 export { buildAgUiBrowserFinalizeResponse, createAgUiBrowserEncoderState, finalizeAgUiBrowserEvents, mapRuntimeStreamEventToAgUiBrowserEvents, } from "./ag-ui-browser-encoder.js";
 export { createAgUiBrowserResponseStream, } from "./ag-ui-browser-response-stream.js";
+export { bootstrapConversationAgentRun, ConversationMessageRecordSchema, ConversationRecordSchema, createConversationMessage, createConversationRecord, ensureConversationProjectLink, fetchConversationRecord, } from "./conversation-bootstrap.js";
 export { CompleteConversationRunResponseSchema, ConversationRunProjectionSchema, ConversationRunTargetsSchema, createConversationAgentRun, finalizeConversationAgentRun, resolveConversationRunTargets, } from "./durable.js";
 export { runHostedChildLifecycle, } from "./hosted-child-lifecycle.js";
 export { runHostedLifecycle, } from "./hosted-lifecycle.js";

package/esm/src/utils/version-constant.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.232";
+export declare const VERSION = "0.1.233";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.232";
+export const VERSION = "0.1.233";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.232",
+  "version": "0.1.233",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -69,6 +69,10 @@
       "import": "./esm/src/agent/index.js",
       "types": "./esm/src/agent/index.d.ts"
     },
+    "./agent/conversation-bootstrap": {
+      "import": "./esm/src/agent/conversation-bootstrap.js",
+      "types": "./esm/src/agent/conversation-bootstrap.d.ts"
+    },
     "./agent/durable": {
       "import": "./esm/src/agent/durable.js",
       "types": "./esm/src/agent/durable.d.ts"

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.232",
+  "version": "0.1.233",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [
@@ -30,6 +30,7 @@ export default {
     "./markdown": "./src/markdown/index.ts",
     "./mdx": "./src/mdx/index.ts",
     "./agent": "./src/agent/index.ts",
+    "./agent/conversation-bootstrap": "./src/agent/conversation-bootstrap.ts",
     "./agent/durable": "./src/agent/durable.ts",
     "./channels/control-plane": "./src/channels/control-plane.ts",
     "./channels/invoke": "./src/channels/invoke.ts",

package/src/src/agent/conversation-bootstrap.ts

@@ -0,0 +1,195 @@
+import "../../_dnt.polyfills.js";
+import * as dntShim from "../../_dnt.shims.js";
+import { z } from "zod";
+import { type ConversationRunProjection, createConversationAgentRun } from "./durable.js";
+
+const CONVERSATION_API_TIMEOUT_MS = 15_000;
+
+export const ConversationRecordSchema = z
+  .object({
+    id: z.string(),
+    projectId: z.string().nullable().optional(),
+    project_id: z.string().nullable().optional(),
+  })
+  .passthrough()
+  .transform((data) => ({
+    id: data.id,
+    projectId: data.projectId ?? data.project_id ?? null,
+  }));
+
+export const ConversationMessageRecordSchema = z.object({
+  id: z.string().uuid(),
+});
+
+export type ConversationRecord = z.infer<typeof ConversationRecordSchema>;
+export type ConversationMessageRecord = z.infer<typeof ConversationMessageRecordSchema>;
+
+async function controlPlaneJson<T>(input: {
+  authToken: string;
+  url: string;
+  method?: "GET" | "POST" | "PATCH";
+  body?: unknown;
+  responseSchema: z.ZodSchema<T>;
+  operation: string;
+}): Promise<T> {
+  const controller = new AbortController();
+  const timeout = dntShim.setTimeout(() => controller.abort(), CONVERSATION_API_TIMEOUT_MS);
+
+  let response: Response;
+  try {
+    response = await fetch(input.url, {
+      method: input.method ?? "GET",
+      headers: {
+        Authorization: `Bearer ${input.authToken}`,
+        "Content-Type": "application/json",
+      },
+      ...(input.body !== undefined ? { body: JSON.stringify(input.body) } : {}),
+      signal: controller.signal,
+    });
+  } catch (error) {
+    if (error instanceof DOMException && error.name === "AbortError") {
+      throw new Error(`${input.operation} timed out after ${CONVERSATION_API_TIMEOUT_MS}ms`);
+    }
+    throw error;
+  } finally {
+    clearTimeout(timeout);
+  }
+
+  if (!response.ok) {
+    const body = await response.text().catch(() => "");
+    throw new Error(
+      `${input.operation} failed (${response.status}): ${body || response.statusText}`,
+    );
+  }
+
+  return input.responseSchema.parse(await response.json());
+}
+
+function buildConversationPath(apiUrl: string, conversationId: string): string {
+  return `${apiUrl}/conversations/${conversationId}`;
+}
+
+function buildConversationMessagesPath(apiUrl: string, conversationId: string): string {
+  return `${buildConversationPath(apiUrl, conversationId)}/messages`;
+}
+
+export async function fetchConversationRecord(input: {
+  authToken: string;
+  apiUrl: string;
+  conversationId: string;
+}): Promise<ConversationRecord> {
+  return controlPlaneJson({
+    authToken: input.authToken,
+    url: buildConversationPath(input.apiUrl, input.conversationId),
+    responseSchema: ConversationRecordSchema,
+    operation: "Fetch conversation",
+  });
+}
+
+export async function ensureConversationProjectLink(input: {
+  authToken: string;
+  apiUrl: string;
+  conversationId: string;
+  projectId: string;
+}): Promise<void> {
+  const conversation = await fetchConversationRecord(input);
+
+  if (conversation.projectId === input.projectId) return;
+  if (conversation.projectId !== null) {
+    throw new Error(
+      `Conversation ${input.conversationId} is already linked to a different project (${conversation.projectId})`,
+    );
+  }
+
+  await controlPlaneJson({
+    authToken: input.authToken,
+    url: buildConversationPath(input.apiUrl, input.conversationId),
+    method: "PATCH",
+    body: { project_id: input.projectId },
+    responseSchema: ConversationRecordSchema,
+    operation: "Link conversation to project",
+  });
+}
+
+export async function createConversationRecord(input: {
+  authToken: string;
+  apiUrl: string;
+  body: unknown;
+}): Promise<ConversationRecord> {
+  return controlPlaneJson({
+    authToken: input.authToken,
+    url: `${input.apiUrl}/conversations`,
+    method: "POST",
+    body: input.body,
+    responseSchema: ConversationRecordSchema,
+    operation: "Create conversation",
+  });
+}
+
+export async function createConversationMessage(input: {
+  authToken: string;
+  apiUrl: string;
+  conversationId: string;
+  body: unknown;
+}): Promise<ConversationMessageRecord> {
+  return controlPlaneJson({
+    authToken: input.authToken,
+    url: buildConversationMessagesPath(input.apiUrl, input.conversationId),
+    method: "POST",
+    body: input.body,
+    responseSchema: ConversationMessageRecordSchema,
+    operation: "Create conversation message",
+  });
+}
+
+export interface BootstrapConversationAgentRunResult {
+  conversation: ConversationRecord;
+  message: ConversationMessageRecord;
+  run: ConversationRunProjection;
+}
+
+export async function bootstrapConversationAgentRun(input: {
+  authToken: string;
+  apiUrl: string;
+  parentConversationId?: string;
+  ensureProjectId?: string;
+  conversationBody: unknown;
+  handoffMessageBody: unknown;
+  runId?: string;
+  agentId: string;
+  projectId?: string | null;
+  branchId?: string | null;
+}): Promise<BootstrapConversationAgentRunResult> {
+  if (input.parentConversationId && input.ensureProjectId) {
+    await ensureConversationProjectLink({
+      authToken: input.authToken,
+      apiUrl: input.apiUrl,
+      conversationId: input.parentConversationId,
+      projectId: input.ensureProjectId,
+    });
+  }
+
+  const conversation = await createConversationRecord({
+    authToken: input.authToken,
+    apiUrl: input.apiUrl,
+    body: input.conversationBody,
+  });
+  const effectiveProjectId = input.projectId ?? conversation.projectId;
+  const message = await createConversationMessage({
+    authToken: input.authToken,
+    apiUrl: input.apiUrl,
+    conversationId: conversation.id,
+    body: input.handoffMessageBody,
+  });
+  const run = await createConversationAgentRun({
+    authToken: input.authToken,
+    apiUrl: input.apiUrl,
+    conversationId: conversation.id,
+    runId: input.runId,
+    agentId: input.agentId,
+    projectId: effectiveProjectId,
+    branchId: input.branchId,
+  });
+
+  return { conversation, message, run };
+}

package/src/src/agent/index.ts

@@ -180,6 +180,18 @@ export {
   createAgUiBrowserResponseStream,
   type CreateAgUiBrowserResponseStreamInput,
 } from "./ag-ui-browser-response-stream.js";
+export {
+  bootstrapConversationAgentRun,
+  type BootstrapConversationAgentRunResult,
+  type ConversationMessageRecord,
+  ConversationMessageRecordSchema,
+  type ConversationRecord,
+  ConversationRecordSchema,
+  createConversationMessage,
+  createConversationRecord,
+  ensureConversationProjectLink,
+  fetchConversationRecord,
+} from "./conversation-bootstrap.js";
 export {
   CompleteConversationRunResponseSchema,
   type ConversationAgentRunUsage,

package/src/src/utils/version-constant.ts

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.232";
+export const VERSION = "0.1.233";