veryfront 0.1.364 → 0.1.366

package/esm/src/agent/input-request-protocol.d.ts.map

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

package/esm/src/agent/input-request-protocol.js

@@ -0,0 +1,168 @@
+import { z } from "zod";
+import { HumanInputFieldSchema, HumanInputRequestSchema } from "./human-input.js";
+export const formInputToolInputSchema = HumanInputRequestSchema.omit({ metadata: true });
+export const inputResponseValuesSchema = z.record(z.string(), z.union([z.string(), z.boolean(), z.number(), z.null()]));
+export const createInputRequestRequestSchema = z.object({
+    run_id: z.string().min(1),
+    tool_call_id: z.string().min(1),
+    kind: z.literal("form"),
+    requested_responder_type: z.literal("human"),
+    title: z.string(),
+    description: z.string().optional(),
+    fields: z.array(HumanInputFieldSchema).min(1),
+    expires_at: z.string().datetime({ offset: true }),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+export const inputResponseRestSchema = z
+    .object({
+    id: z.string().uuid(),
+    input_request_id: z.string().uuid(),
+    conversation_id: z.string().uuid(),
+    run_id: z.string().min(1),
+    actor_type: z.string(),
+    actor_id: z.string(),
+    values: inputResponseValuesSchema,
+    created_at: z.string(),
+})
+    .passthrough()
+    .transform((value) => ({
+    id: value.id,
+    inputRequestId: value.input_request_id,
+    conversationId: value.conversation_id,
+    runId: value.run_id,
+    actorType: value.actor_type,
+    actorId: value.actor_id,
+    values: value.values,
+    createdAt: value.created_at,
+}));
+export const inputRequestRestSchema = z
+    .object({
+    id: z.string().uuid(),
+    conversation_id: z.string().uuid(),
+    run_id: z.string().min(1),
+    tool_call_id: z.string().min(1),
+    kind: z.literal("form"),
+    status: z.enum(["open", "submitted", "cancelled", "expired"]),
+    requested_responder_type: z.enum(["human", "agent", "system"]),
+    title: z.string(),
+    description: z.string().nullable(),
+    fields: z.array(HumanInputFieldSchema),
+    recommendations: z.record(z.string(), z.unknown()).nullable().optional(),
+    metadata: z.record(z.string(), z.unknown()).nullable().optional(),
+    created_at: z.string(),
+    expires_at: z.string().nullable(),
+    submitted_at: z.string().nullable().optional(),
+    cancelled_at: z.string().nullable().optional(),
+    expired_at: z.string().nullable().optional(),
+    latest_response: inputResponseRestSchema.nullable().optional(),
+})
+    .passthrough()
+    .transform((value) => ({
+    id: value.id,
+    conversationId: value.conversation_id,
+    runId: value.run_id,
+    toolCallId: value.tool_call_id,
+    kind: value.kind,
+    status: value.status,
+    requestedResponderType: value.requested_responder_type,
+    title: value.title,
+    description: value.description,
+    fields: value.fields,
+    recommendations: value.recommendations ?? null,
+    metadata: value.metadata ?? null,
+    createdAt: value.created_at,
+    expiresAt: value.expires_at,
+    submittedAt: value.submitted_at ?? null,
+    cancelledAt: value.cancelled_at ?? null,
+    expiredAt: value.expired_at ?? null,
+    latestResponse: value.latest_response ?? null,
+}));
+export const createInputRequestResponseSchema = inputRequestRestSchema;
+export const getInputRequestResponseSchema = inputRequestRestSchema;
+export const inputRequestOutputSchema = z.object({
+    id: z.string().uuid(),
+    conversationId: z.string().uuid(),
+    runId: z.string().min(1),
+    toolCallId: z.string().min(1),
+    kind: z.literal("form"),
+    status: z.enum(["open", "submitted", "cancelled", "expired"]),
+    requestedResponderType: z.enum(["human", "agent", "system"]),
+    title: z.string(),
+    description: z.string().nullable(),
+    fields: z.array(HumanInputFieldSchema),
+    recommendations: z.record(z.string(), z.unknown()).nullable(),
+    metadata: z.record(z.string(), z.unknown()).nullable(),
+    createdAt: z.string(),
+    expiresAt: z.string().nullable(),
+    submittedAt: z.string().nullable(),
+    cancelledAt: z.string().nullable(),
+    expiredAt: z.string().nullable(),
+    latestResponse: inputResponseRestSchema.nullable(),
+});
+export const inputRequestLifecycleDataEventSchema = z.object({
+    type: z.literal("veryfront.input_request.lifecycle"),
+    data: z.object({
+        action: z.enum(["created", "updated"]),
+        inputRequest: inputRequestOutputSchema,
+    }),
+    name: z.literal("veryfront.input_request.lifecycle"),
+    value: z.object({
+        action: z.enum(["created", "updated"]),
+        inputRequest: inputRequestOutputSchema,
+    }),
+});
+export async function createInputRequest(input) {
+    const requestBody = createInputRequestRequestSchema.parse({
+        run_id: input.runId,
+        tool_call_id: input.toolCallId,
+        kind: "form",
+        requested_responder_type: "human",
+        title: input.form.title,
+        ...(input.form.description ? { description: input.form.description } : {}),
+        fields: input.form.fields,
+        expires_at: input.expiresAt,
+        ...(input.form.submitLabel ? { metadata: { submitLabel: input.form.submitLabel } } : {}),
+    });
+    const response = await fetch(`${input.apiUrl}/conversations/${input.conversationId}/input-requests`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${input.authToken}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(requestBody),
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!response.ok) {
+        const detail = await response.text().catch(() => "");
+        throw new Error(detail || `Failed to create durable input request (HTTP ${response.status})`);
+    }
+    return createInputRequestResponseSchema.parse(await response.json());
+}
+export async function getInputRequest(input) {
+    const response = await fetch(`${input.apiUrl}/conversations/${input.conversationId}/input-requests/${input.inputRequestId}`, {
+        method: "GET",
+        headers: {
+            Authorization: `Bearer ${input.authToken}`,
+        },
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!response.ok) {
+        const detail = await response.text().catch(() => "");
+        throw new Error(detail || `Failed to fetch durable input request (HTTP ${response.status})`);
+    }
+    return getInputRequestResponseSchema.parse(await response.json());
+}
+export function buildInputRequestLifecycleDataEvent(input) {
+    return inputRequestLifecycleDataEventSchema.parse({
+        type: "veryfront.input_request.lifecycle",
+        data: {
+            action: input.action,
+            inputRequest: input.inputRequest,
+        },
+        name: "veryfront.input_request.lifecycle",
+        value: {
+            action: input.action,
+            inputRequest: input.inputRequest,
+        },
+    });
+}

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

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.364";
+export declare const VERSION = "0.1.366";
 //# 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.364";
+export const VERSION = "0.1.366";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.364",
+  "version": "0.1.366",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.364",
+  "version": "0.1.366",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [

package/src/src/agent/hosted-form-input-tool.ts

@@ -0,0 +1,118 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { tool, type ToolExecutionContext } from "../tool/index.js";
+import { containsExactArtifactPathValue } from "./slash-command-artifact-policy.js";
+import {
+  buildInputRequestLifecycleDataEvent,
+  createInputRequest,
+  type FormInputToolInput,
+  formInputToolInputSchema,
+  getInputRequest,
+  type InputRequestOutput,
+} from "./input-request-protocol.js";
+import { executeDurableHumanInputFlow, type HumanInputResult } from "./human-input.js";
+
+const INPUT_REQUEST_TIMEOUT_MS = 5 * 60_000;
+const INPUT_REQUEST_POLL_INTERVAL_MS = 500;
+
+export interface HostedFormInputToolContext {
+  authToken: string;
+  conversationId?: string;
+  parentRunId?: string;
+  slashCommandArtifactPathSeen?: boolean;
+}
+
+export function createHostedFormInputTool(context: HostedFormInputToolContext, apiUrl: string) {
+  return tool({
+    description:
+      "Display a durable structured form to collect user input. Use this when you need a concrete choice or structured values before continuing. The request is persisted as an input_request and the tool waits until the user submits or the request expires.",
+    inputSchema: formInputToolInputSchema,
+    execute: async (input, execOptions) =>
+      executeDurableFormInputFlow(context, apiUrl, input, execOptions),
+  });
+}
+
+async function executeDurableFormInputFlow(
+  context: HostedFormInputToolContext,
+  apiUrl: string,
+  input: FormInputToolInput,
+  execContext?: ToolExecutionContext,
+) {
+  if (!context.conversationId) {
+    throw new Error("form_input requires a durable conversation context");
+  }
+  if (!context.parentRunId) {
+    throw new Error("form_input requires a durable run context");
+  }
+
+  const conversationId = context.conversationId;
+  const parentRunId = context.parentRunId;
+  const toolCallId =
+    typeof execContext?.toolCallId === "string" && execContext.toolCallId.length > 0
+      ? execContext.toolCallId
+      : `form_input-${dntShim.crypto.randomUUID()}`;
+
+  const { result, createdRequest } = await executeDurableHumanInputFlow({
+    runId: parentRunId,
+    threadId: conversationId,
+    toolCallId,
+    request: input,
+    timeoutMs: INPUT_REQUEST_TIMEOUT_MS + 5_000,
+    pollIntervalMs: INPUT_REQUEST_POLL_INTERVAL_MS,
+    onRequest: async (pendingRequest) => {
+      const created = await createInputRequest({
+        authToken: context.authToken,
+        apiUrl,
+        conversationId,
+        runId: parentRunId,
+        toolCallId,
+        form: pendingRequest.request,
+        expiresAt: new Date(Date.now() + INPUT_REQUEST_TIMEOUT_MS).toISOString(),
+      });
+      await execContext?.publishDataEvent?.(buildInputRequestLifecycleDataEvent({
+        action: "created",
+        inputRequest: created,
+      }));
+      return created;
+    },
+    getSnapshot: (created) =>
+      getInputRequest({
+        authToken: context.authToken,
+        apiUrl,
+        conversationId,
+        inputRequestId: created.id,
+      }),
+    resolveSnapshot: (current) => resolveDurableInputRequestResult(context, current),
+  });
+
+  return {
+    ...result,
+    inputRequestId: createdRequest.id,
+  };
+}
+
+function resolveDurableInputRequestResult(
+  context: HostedFormInputToolContext,
+  snapshot: InputRequestOutput,
+): HumanInputResult | undefined {
+  if (snapshot.status === "submitted") {
+    const values = snapshot.latestResponse?.values ?? {};
+
+    if (containsExactArtifactPathValue(values)) {
+      context.slashCommandArtifactPathSeen = true;
+    }
+
+    return {
+      submitted: true,
+      values,
+    };
+  }
+
+  if (snapshot.status === "cancelled" || snapshot.status === "expired") {
+    return {
+      submitted: false,
+      values: {},
+    };
+  }
+
+  return undefined;
+}

package/src/src/agent/index.ts

@@ -767,6 +767,26 @@ export {
   AgUiRequestSchema,
   createAgUiHandler,
 } from "./ag-ui-handler.js";
+export {
+  createHostedFormInputTool,
+  type HostedFormInputToolContext,
+} from "./hosted-form-input-tool.js";
+export {
+  buildInputRequestLifecycleDataEvent,
+  createInputRequest,
+  createInputRequestRequestSchema,
+  createInputRequestResponseSchema,
+  type FormInputToolInput,
+  formInputToolInputSchema,
+  getInputRequest,
+  getInputRequestResponseSchema,
+  inputRequestLifecycleDataEventSchema,
+  type InputRequestOutput,
+  inputRequestOutputSchema,
+  inputRequestRestSchema,
+  inputResponseRestSchema,
+  inputResponseValuesSchema,
+} from "./input-request-protocol.js";
 export {
   type DurableHumanInputFlowResult,
   executeDurableHumanInputFlow,

package/src/src/agent/input-request-protocol.ts

@@ -0,0 +1,210 @@
+import { z } from "zod";
+import type { ToolExecutionDataEvent } from "../tool/types.js";
+import { HumanInputFieldSchema, HumanInputRequestSchema } from "./human-input.js";
+
+export const formInputToolInputSchema = HumanInputRequestSchema.omit({ metadata: true });
+export const inputResponseValuesSchema = z.record(
+  z.string(),
+  z.union([z.string(), z.boolean(), z.number(), z.null()]),
+);
+
+export const createInputRequestRequestSchema = z.object({
+  run_id: z.string().min(1),
+  tool_call_id: z.string().min(1),
+  kind: z.literal("form"),
+  requested_responder_type: z.literal("human"),
+  title: z.string(),
+  description: z.string().optional(),
+  fields: z.array(HumanInputFieldSchema).min(1),
+  expires_at: z.string().datetime({ offset: true }),
+  metadata: z.record(z.string(), z.unknown()).optional(),
+});
+
+export const inputResponseRestSchema = z
+  .object({
+    id: z.string().uuid(),
+    input_request_id: z.string().uuid(),
+    conversation_id: z.string().uuid(),
+    run_id: z.string().min(1),
+    actor_type: z.string(),
+    actor_id: z.string(),
+    values: inputResponseValuesSchema,
+    created_at: z.string(),
+  })
+  .passthrough()
+  .transform((value) => ({
+    id: value.id,
+    inputRequestId: value.input_request_id,
+    conversationId: value.conversation_id,
+    runId: value.run_id,
+    actorType: value.actor_type,
+    actorId: value.actor_id,
+    values: value.values,
+    createdAt: value.created_at,
+  }));
+
+export const inputRequestRestSchema = z
+  .object({
+    id: z.string().uuid(),
+    conversation_id: z.string().uuid(),
+    run_id: z.string().min(1),
+    tool_call_id: z.string().min(1),
+    kind: z.literal("form"),
+    status: z.enum(["open", "submitted", "cancelled", "expired"]),
+    requested_responder_type: z.enum(["human", "agent", "system"]),
+    title: z.string(),
+    description: z.string().nullable(),
+    fields: z.array(HumanInputFieldSchema),
+    recommendations: z.record(z.string(), z.unknown()).nullable().optional(),
+    metadata: z.record(z.string(), z.unknown()).nullable().optional(),
+    created_at: z.string(),
+    expires_at: z.string().nullable(),
+    submitted_at: z.string().nullable().optional(),
+    cancelled_at: z.string().nullable().optional(),
+    expired_at: z.string().nullable().optional(),
+    latest_response: inputResponseRestSchema.nullable().optional(),
+  })
+  .passthrough()
+  .transform((value) => ({
+    id: value.id,
+    conversationId: value.conversation_id,
+    runId: value.run_id,
+    toolCallId: value.tool_call_id,
+    kind: value.kind,
+    status: value.status,
+    requestedResponderType: value.requested_responder_type,
+    title: value.title,
+    description: value.description,
+    fields: value.fields,
+    recommendations: value.recommendations ?? null,
+    metadata: value.metadata ?? null,
+    createdAt: value.created_at,
+    expiresAt: value.expires_at,
+    submittedAt: value.submitted_at ?? null,
+    cancelledAt: value.cancelled_at ?? null,
+    expiredAt: value.expired_at ?? null,
+    latestResponse: value.latest_response ?? null,
+  }));
+
+export const createInputRequestResponseSchema = inputRequestRestSchema;
+export const getInputRequestResponseSchema = inputRequestRestSchema;
+export const inputRequestOutputSchema = z.object({
+  id: z.string().uuid(),
+  conversationId: z.string().uuid(),
+  runId: z.string().min(1),
+  toolCallId: z.string().min(1),
+  kind: z.literal("form"),
+  status: z.enum(["open", "submitted", "cancelled", "expired"]),
+  requestedResponderType: z.enum(["human", "agent", "system"]),
+  title: z.string(),
+  description: z.string().nullable(),
+  fields: z.array(HumanInputFieldSchema),
+  recommendations: z.record(z.string(), z.unknown()).nullable(),
+  metadata: z.record(z.string(), z.unknown()).nullable(),
+  createdAt: z.string(),
+  expiresAt: z.string().nullable(),
+  submittedAt: z.string().nullable(),
+  cancelledAt: z.string().nullable(),
+  expiredAt: z.string().nullable(),
+  latestResponse: inputResponseRestSchema.nullable(),
+});
+
+export const inputRequestLifecycleDataEventSchema = z.object({
+  type: z.literal("veryfront.input_request.lifecycle"),
+  data: z.object({
+    action: z.enum(["created", "updated"]),
+    inputRequest: inputRequestOutputSchema,
+  }),
+  name: z.literal("veryfront.input_request.lifecycle"),
+  value: z.object({
+    action: z.enum(["created", "updated"]),
+    inputRequest: inputRequestOutputSchema,
+  }),
+});
+
+export type FormInputToolInput = z.infer<typeof formInputToolInputSchema>;
+export type InputRequestOutput = z.infer<typeof inputRequestOutputSchema>;
+
+export async function createInputRequest(input: {
+  authToken: string;
+  apiUrl: string;
+  conversationId: string;
+  runId: string;
+  toolCallId: string;
+  form: FormInputToolInput;
+  expiresAt: string;
+}): Promise<InputRequestOutput> {
+  const requestBody = createInputRequestRequestSchema.parse({
+    run_id: input.runId,
+    tool_call_id: input.toolCallId,
+    kind: "form",
+    requested_responder_type: "human",
+    title: input.form.title,
+    ...(input.form.description ? { description: input.form.description } : {}),
+    fields: input.form.fields,
+    expires_at: input.expiresAt,
+    ...(input.form.submitLabel ? { metadata: { submitLabel: input.form.submitLabel } } : {}),
+  });
+  const response = await fetch(
+    `${input.apiUrl}/conversations/${input.conversationId}/input-requests`,
+    {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${input.authToken}`,
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify(requestBody),
+      signal: AbortSignal.timeout(15_000),
+    },
+  );
+
+  if (!response.ok) {
+    const detail = await response.text().catch(() => "");
+    throw new Error(detail || `Failed to create durable input request (HTTP ${response.status})`);
+  }
+
+  return createInputRequestResponseSchema.parse(await response.json());
+}
+
+export async function getInputRequest(input: {
+  authToken: string;
+  apiUrl: string;
+  conversationId: string;
+  inputRequestId: string;
+}): Promise<InputRequestOutput> {
+  const response = await fetch(
+    `${input.apiUrl}/conversations/${input.conversationId}/input-requests/${input.inputRequestId}`,
+    {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${input.authToken}`,
+      },
+      signal: AbortSignal.timeout(15_000),
+    },
+  );
+
+  if (!response.ok) {
+    const detail = await response.text().catch(() => "");
+    throw new Error(detail || `Failed to fetch durable input request (HTTP ${response.status})`);
+  }
+
+  return getInputRequestResponseSchema.parse(await response.json());
+}
+
+export function buildInputRequestLifecycleDataEvent(input: {
+  action: "created" | "updated";
+  inputRequest: InputRequestOutput;
+}): ToolExecutionDataEvent {
+  return inputRequestLifecycleDataEventSchema.parse({
+    type: "veryfront.input_request.lifecycle",
+    data: {
+      action: input.action,
+      inputRequest: input.inputRequest,
+    },
+    name: "veryfront.input_request.lifecycle",
+    value: {
+      action: input.action,
+      inputRequest: input.inputRequest,
+    },
+  });
+}

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.364";
+export const VERSION = "0.1.366";