@webless/agent 0.8.0 → 0.9.0

package/dist/index.d.cts

@@ -1,182 +1,5 @@
-declare const AGENT_TOOL_UI_SCHEMA_VERSION: "webless.tool-ui.v1";
-declare const AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION: "webless.structured-tool-input.v1";
-declare const AGENT_STRUCTURED_TOOL_INPUT_HEADER: "Webless-Structured-Tool-Input-JSON:";
-type AgentToolUiFieldKind = "text" | "textarea" | "email" | "number" | "select" | "multi-select" | "checkbox" | "confirmation" | "radio" | "date" | "time" | "date-time" | "calendar" | "range" | "json";
-type AgentToolUiOption = {
-    label: string;
-    value: AgentToolResultJsonValue;
-};
-type AgentToolUiField = {
-    description?: string;
-    kind: AgentToolUiFieldKind;
-    label: string;
-    max?: number;
-    maxItems?: number;
-    maxLength?: number;
-    min?: number;
-    minLength?: number;
-    options?: readonly AgentToolUiOption[];
-    path: string;
-    placeholder?: string;
-    required?: boolean;
-    step?: number;
-    defaultValue?: AgentToolResultJsonValue;
-};
-type AgentToolUiStep = {
-    description?: string;
-    fieldPaths: readonly string[];
-    id: string;
-    label: string;
-};
-type AgentToolUiAction = {
-    id: "submit" | "back" | "next" | "reset";
-    label: string;
-};
-type AgentToolUiSurface = {
-    actions?: readonly AgentToolUiAction[];
-    description?: string;
-    fields: readonly AgentToolUiField[];
-    id: string;
-    operationId?: string;
-    requestId?: string;
-    schemaVersion: typeof AGENT_TOOL_UI_SCHEMA_VERSION;
-    steps?: readonly AgentToolUiStep[];
-    submitLabel?: string;
-    title: string;
-    toolSlug: string;
-    values?: Readonly<Record<string, AgentToolResultJsonValue>>;
-};
-type AgentStructuredToolInput = {
-    schemaVersion: typeof AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION;
-    operationId?: string;
-    toolSlug: string;
-    values: Readonly<Record<string, AgentToolResultJsonValue>>;
-};
-declare function formatAgentStructuredToolInput(surface: AgentToolUiSurface, values: Readonly<Record<string, AgentToolResultJsonValue>>): string;
-declare function parseAgentToolUiSurface(value: unknown): AgentToolUiSurface | null;
-
-type AgentToolResultJsonValue = null | boolean | number | string | AgentToolResultJsonValue[] | {
-    [key: string]: AgentToolResultJsonValue;
-};
-type AgentToolResultEnvelope = {
-    schemaVersion: "webless.tool-result.v1";
-    output: AgentToolResultJsonValue;
-    presentationKinds: string[];
-    ui?: AgentToolUiSurface;
-};
-declare function parseAgentToolResultEnvelope(value: unknown): AgentToolResultEnvelope | null;
-
-type AgentIndexVersion = "published" | "unpublished";
-type AgentRuntimeConfig = {
-    origin: string;
-    indexId: string;
-    version: AgentIndexVersion;
-    host: string;
-};
-type AgentWorkItem = {
-    id: string;
-    kind: "planning" | "search" | "specialist";
-    label: string;
-    state: "completed" | "active" | "pending" | "error";
-    detail?: string;
-};
-type AgentInputOption = {
-    id: string;
-    label: string;
-    description?: string;
-    style?: "default" | "primary" | "danger";
-};
-type AgentInputRequest = {
-    requestId: string;
-    kind: "question" | "session-limit" | "tool-approval";
-    prompt: string;
-    display?: "confirmation" | "select" | "text";
-    allowFreeform?: boolean;
-    options?: readonly AgentInputOption[];
-    ui?: AgentToolUiSurface;
-    action: {
-        callId: string;
-        kind: "tool-call";
-        toolName: string;
-    };
-};
-type AgentInputResponse = {
-    requestId: string;
-    optionId?: string;
-    text?: string;
-    value?: AgentToolResultJsonValue;
-};
-type AgentToolResult = {
-    callId: string;
-    toolName: string;
-    status: "completed" | "failed" | "rejected";
-    output?: unknown;
-    error?: {
-        code: string;
-        message: string;
-    };
-};
-type AgentStreamHandlers = {
-    onWork?: (item: AgentWorkItem) => void;
-    /** @deprecated Use onWork for semantic progress events. */
-    onStep?: (label: string, detail?: string) => void;
-    onDelta: (delta: string) => void;
-    onComplete?: () => void;
-    onActionResult?: (output: unknown) => void;
-    onToolResult?: (result: AgentToolResult) => void;
-    onInputRequest?: (requests: readonly AgentInputRequest[]) => void;
-};
-type AgentSendTurnOptions = {
-    signal?: AbortSignal;
-    handlers: AgentStreamHandlers;
-};
-type AgentResumeTurnOptions = AgentSendTurnOptions & {
-    initialText?: string;
-    message: string;
-};
-type AgentRespondTurnOptions = AgentSendTurnOptions & {
-    responses: readonly AgentInputResponse[];
-};
-type PersistedAgentSession = {
-    sessionId: string;
-    streamIndex: number;
-    lastMessage?: string;
-};
-type AgentClientOptions = {
-    /** Index id sent as `indexId` query param to the runtime. */
-    indexId: string;
-    /** Selects the published index by default, or its unpublished preview. */
-    version?: AgentIndexVersion;
-    /** Supplies a fresh Console authorization grant for unpublished previews. */
-    getUnpublishedPreviewGrant?: () => Promise<string>;
-    /** Ready unpublished build id carried by a generated preview URL. */
-    previewBuildId?: string;
-    /** Customer id used to isolate browser session storage when omitted from storageKeyPrefix. */
-    customerId?: string;
-    /** Agent runtime origin, e.g. `https://runtime.staging.webless.ai`. */
-    runtimeOrigin?: string;
-    /** Stable browser conversation id; generated and stored when omitted. */
-    visitorSessionId?: string;
-    /** Override sessionStorage key prefix (derived from agent identity when omitted). */
-    storageKeyPrefix?: string;
-};
-type AgentClient = {
-    readonly indexId: string;
-    readonly version: AgentIndexVersion;
-    readonly runtimeOrigin: string;
-    readonly visitorSessionId: string;
-    sendTurn: (message: string, options: AgentSendTurnOptions) => Promise<string>;
-    regenerateTurn: (message: string, options: AgentSendTurnOptions) => Promise<string>;
-    resumeTurn: (options: AgentResumeTurnOptions) => Promise<string | null>;
-    respondTurn: (options: AgentRespondTurnOptions) => Promise<string>;
-    reset: () => void;
-    cancelActive: () => void;
-    getActiveSessionId: () => string | undefined;
-};
-type AgentHealthResult = {
-    ok: boolean;
-    detail: string;
-};
+import { d as AgentClientOptions, c as AgentClient, f as AgentIndexVersion, l as AgentRuntimeConfig, e as AgentHealthResult, P as PersistedAgentSession } from './types-ohWeTG9i.cjs';
+export { A as AGENT_STRUCTURED_TOOL_INPUT_HEADER, a as AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION, b as AGENT_TOOL_UI_SCHEMA_VERSION, g as AgentInputOption, h as AgentInputRequest, i as AgentInputResponse, j as AgentRespondTurnOptions, k as AgentResumeTurnOptions, m as AgentSendTurnOptions, n as AgentStreamHandlers, o as AgentStructuredToolInput, p as AgentToolResult, q as AgentToolResultEnvelope, r as AgentToolResultJsonValue, s as AgentToolUiAction, t as AgentToolUiField, u as AgentToolUiFieldKind, v as AgentToolUiOption, w as AgentToolUiStep, x as AgentToolUiSurface, y as AgentWorkItem, z as formatAgentStructuredToolInput, B as parseAgentToolResultEnvelope, C as parseAgentToolUiSurface } from './types-ohWeTG9i.cjs';
 
 declare function createAgentClient(options: AgentClientOptions): AgentClient;
 
@@ -208,4 +31,4 @@ declare function loadPersistedAgentSession(visitorSessionId: string, options?: S
 declare function savePersistedAgentSession(visitorSessionId: string, sessionId: string, streamIndex: number, options?: SessionStoreOptions): void;
 declare function clearPersistedAgentSession(visitorSessionId: string, options?: SessionStoreOptions): void;
 
-export { AGENT_STRUCTURED_TOOL_INPUT_HEADER, AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION, AGENT_TOOL_UI_SCHEMA_VERSION, type AgentClient, type AgentClientOptions, type AgentHealthResult, type AgentIndexVersion, type AgentInputOption, type AgentInputRequest, type AgentInputResponse, type AgentRespondTurnOptions, type AgentResumeTurnOptions, type AgentRuntimeConfig, type AgentSendTurnOptions, type AgentStreamHandlers, type AgentStructuredToolInput, type AgentToolResult, type AgentToolResultEnvelope, type AgentToolResultJsonValue, type AgentToolUiAction, type AgentToolUiField, type AgentToolUiFieldKind, type AgentToolUiOption, type AgentToolUiStep, type AgentToolUiSurface, type AgentWorkItem, DEFAULT_RUNTIME_ORIGIN, type PersistedAgentSession, type SessionStoreOptions, agentHealthUrl, buildAgentStorageKeyPrefix, buildEveHost, clearPersistedAgentSession, clearVisitorSessionId, createAgentClient, formatAgentError, formatAgentStructuredToolInput, getOrCreateVisitorSessionId, loadPersistedAgentSession, parseAgentToolResultEnvelope, parseAgentToolUiSurface, pingAgentHealth, resolveAgentRuntimeConfig, savePersistedAgentSession };
+export { AgentClient, AgentClientOptions, AgentHealthResult, AgentIndexVersion, AgentRuntimeConfig, DEFAULT_RUNTIME_ORIGIN, PersistedAgentSession, type SessionStoreOptions, agentHealthUrl, buildAgentStorageKeyPrefix, buildEveHost, clearPersistedAgentSession, clearVisitorSessionId, createAgentClient, formatAgentError, getOrCreateVisitorSessionId, loadPersistedAgentSession, pingAgentHealth, resolveAgentRuntimeConfig, savePersistedAgentSession };

package/dist/index.d.ts

@@ -1,182 +1,5 @@
-declare const AGENT_TOOL_UI_SCHEMA_VERSION: "webless.tool-ui.v1";
-declare const AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION: "webless.structured-tool-input.v1";
-declare const AGENT_STRUCTURED_TOOL_INPUT_HEADER: "Webless-Structured-Tool-Input-JSON:";
-type AgentToolUiFieldKind = "text" | "textarea" | "email" | "number" | "select" | "multi-select" | "checkbox" | "confirmation" | "radio" | "date" | "time" | "date-time" | "calendar" | "range" | "json";
-type AgentToolUiOption = {
-    label: string;
-    value: AgentToolResultJsonValue;
-};
-type AgentToolUiField = {
-    description?: string;
-    kind: AgentToolUiFieldKind;
-    label: string;
-    max?: number;
-    maxItems?: number;
-    maxLength?: number;
-    min?: number;
-    minLength?: number;
-    options?: readonly AgentToolUiOption[];
-    path: string;
-    placeholder?: string;
-    required?: boolean;
-    step?: number;
-    defaultValue?: AgentToolResultJsonValue;
-};
-type AgentToolUiStep = {
-    description?: string;
-    fieldPaths: readonly string[];
-    id: string;
-    label: string;
-};
-type AgentToolUiAction = {
-    id: "submit" | "back" | "next" | "reset";
-    label: string;
-};
-type AgentToolUiSurface = {
-    actions?: readonly AgentToolUiAction[];
-    description?: string;
-    fields: readonly AgentToolUiField[];
-    id: string;
-    operationId?: string;
-    requestId?: string;
-    schemaVersion: typeof AGENT_TOOL_UI_SCHEMA_VERSION;
-    steps?: readonly AgentToolUiStep[];
-    submitLabel?: string;
-    title: string;
-    toolSlug: string;
-    values?: Readonly<Record<string, AgentToolResultJsonValue>>;
-};
-type AgentStructuredToolInput = {
-    schemaVersion: typeof AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION;
-    operationId?: string;
-    toolSlug: string;
-    values: Readonly<Record<string, AgentToolResultJsonValue>>;
-};
-declare function formatAgentStructuredToolInput(surface: AgentToolUiSurface, values: Readonly<Record<string, AgentToolResultJsonValue>>): string;
-declare function parseAgentToolUiSurface(value: unknown): AgentToolUiSurface | null;
-
-type AgentToolResultJsonValue = null | boolean | number | string | AgentToolResultJsonValue[] | {
-    [key: string]: AgentToolResultJsonValue;
-};
-type AgentToolResultEnvelope = {
-    schemaVersion: "webless.tool-result.v1";
-    output: AgentToolResultJsonValue;
-    presentationKinds: string[];
-    ui?: AgentToolUiSurface;
-};
-declare function parseAgentToolResultEnvelope(value: unknown): AgentToolResultEnvelope | null;
-
-type AgentIndexVersion = "published" | "unpublished";
-type AgentRuntimeConfig = {
-    origin: string;
-    indexId: string;
-    version: AgentIndexVersion;
-    host: string;
-};
-type AgentWorkItem = {
-    id: string;
-    kind: "planning" | "search" | "specialist";
-    label: string;
-    state: "completed" | "active" | "pending" | "error";
-    detail?: string;
-};
-type AgentInputOption = {
-    id: string;
-    label: string;
-    description?: string;
-    style?: "default" | "primary" | "danger";
-};
-type AgentInputRequest = {
-    requestId: string;
-    kind: "question" | "session-limit" | "tool-approval";
-    prompt: string;
-    display?: "confirmation" | "select" | "text";
-    allowFreeform?: boolean;
-    options?: readonly AgentInputOption[];
-    ui?: AgentToolUiSurface;
-    action: {
-        callId: string;
-        kind: "tool-call";
-        toolName: string;
-    };
-};
-type AgentInputResponse = {
-    requestId: string;
-    optionId?: string;
-    text?: string;
-    value?: AgentToolResultJsonValue;
-};
-type AgentToolResult = {
-    callId: string;
-    toolName: string;
-    status: "completed" | "failed" | "rejected";
-    output?: unknown;
-    error?: {
-        code: string;
-        message: string;
-    };
-};
-type AgentStreamHandlers = {
-    onWork?: (item: AgentWorkItem) => void;
-    /** @deprecated Use onWork for semantic progress events. */
-    onStep?: (label: string, detail?: string) => void;
-    onDelta: (delta: string) => void;
-    onComplete?: () => void;
-    onActionResult?: (output: unknown) => void;
-    onToolResult?: (result: AgentToolResult) => void;
-    onInputRequest?: (requests: readonly AgentInputRequest[]) => void;
-};
-type AgentSendTurnOptions = {
-    signal?: AbortSignal;
-    handlers: AgentStreamHandlers;
-};
-type AgentResumeTurnOptions = AgentSendTurnOptions & {
-    initialText?: string;
-    message: string;
-};
-type AgentRespondTurnOptions = AgentSendTurnOptions & {
-    responses: readonly AgentInputResponse[];
-};
-type PersistedAgentSession = {
-    sessionId: string;
-    streamIndex: number;
-    lastMessage?: string;
-};
-type AgentClientOptions = {
-    /** Index id sent as `indexId` query param to the runtime. */
-    indexId: string;
-    /** Selects the published index by default, or its unpublished preview. */
-    version?: AgentIndexVersion;
-    /** Supplies a fresh Console authorization grant for unpublished previews. */
-    getUnpublishedPreviewGrant?: () => Promise<string>;
-    /** Ready unpublished build id carried by a generated preview URL. */
-    previewBuildId?: string;
-    /** Customer id used to isolate browser session storage when omitted from storageKeyPrefix. */
-    customerId?: string;
-    /** Agent runtime origin, e.g. `https://runtime.staging.webless.ai`. */
-    runtimeOrigin?: string;
-    /** Stable browser conversation id; generated and stored when omitted. */
-    visitorSessionId?: string;
-    /** Override sessionStorage key prefix (derived from agent identity when omitted). */
-    storageKeyPrefix?: string;
-};
-type AgentClient = {
-    readonly indexId: string;
-    readonly version: AgentIndexVersion;
-    readonly runtimeOrigin: string;
-    readonly visitorSessionId: string;
-    sendTurn: (message: string, options: AgentSendTurnOptions) => Promise<string>;
-    regenerateTurn: (message: string, options: AgentSendTurnOptions) => Promise<string>;
-    resumeTurn: (options: AgentResumeTurnOptions) => Promise<string | null>;
-    respondTurn: (options: AgentRespondTurnOptions) => Promise<string>;
-    reset: () => void;
-    cancelActive: () => void;
-    getActiveSessionId: () => string | undefined;
-};
-type AgentHealthResult = {
-    ok: boolean;
-    detail: string;
-};
+import { d as AgentClientOptions, c as AgentClient, f as AgentIndexVersion, l as AgentRuntimeConfig, e as AgentHealthResult, P as PersistedAgentSession } from './types-ohWeTG9i.js';
+export { A as AGENT_STRUCTURED_TOOL_INPUT_HEADER, a as AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION, b as AGENT_TOOL_UI_SCHEMA_VERSION, g as AgentInputOption, h as AgentInputRequest, i as AgentInputResponse, j as AgentRespondTurnOptions, k as AgentResumeTurnOptions, m as AgentSendTurnOptions, n as AgentStreamHandlers, o as AgentStructuredToolInput, p as AgentToolResult, q as AgentToolResultEnvelope, r as AgentToolResultJsonValue, s as AgentToolUiAction, t as AgentToolUiField, u as AgentToolUiFieldKind, v as AgentToolUiOption, w as AgentToolUiStep, x as AgentToolUiSurface, y as AgentWorkItem, z as formatAgentStructuredToolInput, B as parseAgentToolResultEnvelope, C as parseAgentToolUiSurface } from './types-ohWeTG9i.js';
 
 declare function createAgentClient(options: AgentClientOptions): AgentClient;
 
@@ -208,4 +31,4 @@ declare function loadPersistedAgentSession(visitorSessionId: string, options?: S
 declare function savePersistedAgentSession(visitorSessionId: string, sessionId: string, streamIndex: number, options?: SessionStoreOptions): void;
 declare function clearPersistedAgentSession(visitorSessionId: string, options?: SessionStoreOptions): void;
 
-export { AGENT_STRUCTURED_TOOL_INPUT_HEADER, AGENT_STRUCTURED_TOOL_INPUT_SCHEMA_VERSION, AGENT_TOOL_UI_SCHEMA_VERSION, type AgentClient, type AgentClientOptions, type AgentHealthResult, type AgentIndexVersion, type AgentInputOption, type AgentInputRequest, type AgentInputResponse, type AgentRespondTurnOptions, type AgentResumeTurnOptions, type AgentRuntimeConfig, type AgentSendTurnOptions, type AgentStreamHandlers, type AgentStructuredToolInput, type AgentToolResult, type AgentToolResultEnvelope, type AgentToolResultJsonValue, type AgentToolUiAction, type AgentToolUiField, type AgentToolUiFieldKind, type AgentToolUiOption, type AgentToolUiStep, type AgentToolUiSurface, type AgentWorkItem, DEFAULT_RUNTIME_ORIGIN, type PersistedAgentSession, type SessionStoreOptions, agentHealthUrl, buildAgentStorageKeyPrefix, buildEveHost, clearPersistedAgentSession, clearVisitorSessionId, createAgentClient, formatAgentError, formatAgentStructuredToolInput, getOrCreateVisitorSessionId, loadPersistedAgentSession, parseAgentToolResultEnvelope, parseAgentToolUiSurface, pingAgentHealth, resolveAgentRuntimeConfig, savePersistedAgentSession };
+export { AgentClient, AgentClientOptions, AgentHealthResult, AgentIndexVersion, AgentRuntimeConfig, DEFAULT_RUNTIME_ORIGIN, PersistedAgentSession, type SessionStoreOptions, agentHealthUrl, buildAgentStorageKeyPrefix, buildEveHost, clearPersistedAgentSession, clearVisitorSessionId, createAgentClient, formatAgentError, getOrCreateVisitorSessionId, loadPersistedAgentSession, pingAgentHealth, resolveAgentRuntimeConfig, savePersistedAgentSession };