@vinaverse/server 0.1.0-alpha.21 → 0.1.0-alpha.22

package/dist/{provider-1SsRbyN-.d.ts → provider-DsFlhWPu.d.ts}

@@ -1,4 +1,4 @@
-import { c as components$1, w as webhooks } from './vinaverse-v1.d-D-NPpZqW.js';
+import { c as components$1, w as webhooks } from './vinaverse-v1.d-C3ZVGBVA.js';
 import { c as NonceStore, a as IdempotencyStore } from './nonces-scwljZwl.js';
 
 /**
@@ -403,6 +403,23 @@ declare const TOOL_OPERATIONS: {
             };
         };
     };
+    readonly read_proposal: {
+        readonly id: "read_proposal";
+        readonly method: "GET";
+        readonly path: "/proposals/{id}";
+        readonly effect: "read";
+        readonly maxResultBytes: 16384;
+        readonly successStatus: 200;
+        readonly idempotencyKey: false;
+        readonly body: false;
+        readonly pathParams: {
+            readonly id: {
+                readonly type: "string";
+                readonly required: true;
+            };
+        };
+        readonly queryParams: {};
+    };
     readonly resolve_place: {
         readonly id: "resolve_place";
         readonly method: "GET";
@@ -807,7 +824,14 @@ interface components {
             expires_at: string;
             /** @description A link into the tenant's app, to edit the change there. It must start with a prefix registered for the environment and pass the link checks (`admin-v1.yaml`, `Connector.deep_link_prefixes`). The runtime removes one that fails, and the proposal is still shown. */
             edit_deep_link?: string;
-        } & (unknown & unknown & unknown & unknown);
+            /** @description v1-draft.18, only once the proposal is `confirmed`: what the tenant saved, as its own setup read says it. Absent before it is applied. The agent says what was saved from it, never what it proposed. */
+            applied?: {
+                /** @description the setup step it belongs to */
+                step?: string;
+                /** @description one line per field saved, in the tenant's words; never a bank or card detail, a document number or a balance, since the agent repeats them to the person */
+                summary: string[];
+            };
+        } & (unknown & unknown & unknown & unknown & unknown);
         /** @description The fields of a booking proposal (topic `booking`, `booking_reschedule` or `booking_cancellation`), whose keys are fixed so every app draws a booking card the same way (`docs/agents-guardrails-suggestions-writes.md` §3.4): `service`, `professional`, `space`, `booking`, `location`, `note` and `reason` are `text`, `services` is a `list`, `time` is a `time_range`, `place` an `address`, and `price`, `deposit`, `fee`, `cancellation_fee` and `refund` are `money_cents`. */
         BookingFields: (unknown & unknown & unknown & unknown & unknown)[];
         /** @description `before` is the current value, absent or null when the proposal creates it, and equal to `after` when the field does not change but says what the change is about (the booking a reschedule moves); `before` and `after` take the shape `type` names. */
@@ -883,9 +907,34 @@ interface components {
             reason?: string;
             /** @description the action's words on its `next_step` card */
             label?: string;
+            /** @description v1-draft.17: whether the step is needed before the business can go live. `false` for a recommended step (payouts), which never stops it; left out, the step counts as required. */
+            required?: boolean;
             /** @description For a step finished on the tenant's own screen, a link into the tenant's app. It must start with a prefix registered for the environment and pass the link checks (`admin-v1.yaml`, `Connector.deep_link_prefixes`). The runtime removes one that fails, and the step is then shown without a card. */
             deep_link?: string;
         } & unknown;
+        /** @description v1-draft.17: the state of the business's own payout account, read under the `payouts` capability (a professional, host or staff subject; the tenant answers for the business of the session's delegated token). Never a bank or card detail, a balance, or a payout amount other than what waits to be paid out. */
+        PayoutAccount: {
+            /**
+             * @description `not_started`: nothing connected yet; `onboarding`: setup begun and not finished; `pending_verification`: the payment provider is reviewing the details; `action_required`: the business must give something more (`missing`); `active`: payouts are sent; `restricted`: payouts are paused by the provider; `rejected`: the account was refused.
+             * @enum {string}
+             */
+            state: "not_started" | "onboarding" | "pending_verification" | "action_required" | "active" | "restricted" | "rejected";
+            /** @description whether the business must act before payouts can be sent */
+            action_required?: boolean;
+            /** @description the codes of the requirements still missing, never the values given for them */
+            missing?: string[];
+            /** @description how fresh the state is, as the tenant names it; `refresh_failed` means the last state known */
+            sync_state?: string;
+            /** @description the tenant's payout screen, under a registered prefix (`admin-v1.yaml`, `Connector.deep_link_prefixes`) */
+            deep_link?: string;
+            /** @description what the business has earned from bookings that waits to be paid out, left out when nothing waits. The tenant returns it only to a subject its own rules let see the business's money (the owner; a staff member only when the tenant allows it), and leaves it out for anyone else; the state stays readable to all */
+            waiting_earnings?: components["schemas"]["Money"];
+            /**
+             * Format: date-time
+             * @description since when the oldest of it waits
+             */
+            waiting_since?: string;
+        };
         /** @description One of the signed-in customer's kits: items a styling-kit retailer sends to try at home, each kept or returned, the kept ones charged. `status` is where the kit is in its life: `preparing` (being put together), `shipped` (on its way), `delivered` (arrived, deciding not open yet), `feedback_open` (the customer decides keep or return for each item, until `feedback_closes_at`), `feedback_closed` (the decisions are in; the items to return are due back by `return_by`), `returned` (the returned items arrived), `billed` (the kept items were charged: `order_id`), `cancelled`. A retailer whose kits skip a state (feedback opens on delivery) never sends it. "What do I still need to do" is answered by `undecided_count` and each item's `decision` before `feedback_closes_at`, and by the items to return and `return_by` after it. */
         Kit: {
             /** @constant */
@@ -1513,6 +1562,19 @@ interface operations {
                             /** Format: date-time */
                             end: string;
                         }[];
+                        /** @description v1-draft.19, the service the times are for */
+                        service_name?: string;
+                        /** @description v1-draft.19, that service's length */
+                        duration_minutes?: number;
+                        /** @description v1-draft.19, true when no service was asked and the tenant took the professional's shortest */
+                        service_assumed?: boolean;
+                        /** @description v1-draft.19, only when `slots` is empty: the first open time the tenant found after the window (it may look up to 60 days ahead); absent when it found none */
+                        next_available?: {
+                            /** Format: date */
+                            date: string;
+                            /** Format: date-time */
+                            start?: string;
+                        };
                     };
                 };
             };
@@ -1908,6 +1970,34 @@ interface operations {
             default: components["responses"]["Problem"];
         };
     };
+    read_proposal: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description on every tool call in a session, a channel session's included (never on the catalogue sweep), the session's id; informational and not signed */
+                "Vinaverse-Session"?: components["parameters"]["VinaverseSession"];
+                /** @description on every tool call of a session that belongs to a conversation (never on the catalogue sweep), its id; informational and not signed */
+                "Vinaverse-Conversation"?: components["parameters"]["VinaverseConversation"];
+            };
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Proposal"];
+                };
+            };
+            default: components["responses"]["Problem"];
+        };
+    };
     get_flow_definition: {
         parameters: {
             query?: {

package/dist/{provider-DhsUFcqq.d.cts → provider-PSwJ554B.d.cts}

@@ -1,4 +1,4 @@
-import { c as components$1, w as webhooks } from './vinaverse-v1.d-D-NPpZqW.cjs';
+import { c as components$1, w as webhooks } from './vinaverse-v1.d-C3ZVGBVA.cjs';
 import { c as NonceStore, a as IdempotencyStore } from './nonces-scwljZwl.cjs';
 
 /**
@@ -403,6 +403,23 @@ declare const TOOL_OPERATIONS: {
             };
         };
     };
+    readonly read_proposal: {
+        readonly id: "read_proposal";
+        readonly method: "GET";
+        readonly path: "/proposals/{id}";
+        readonly effect: "read";
+        readonly maxResultBytes: 16384;
+        readonly successStatus: 200;
+        readonly idempotencyKey: false;
+        readonly body: false;
+        readonly pathParams: {
+            readonly id: {
+                readonly type: "string";
+                readonly required: true;
+            };
+        };
+        readonly queryParams: {};
+    };
     readonly resolve_place: {
         readonly id: "resolve_place";
         readonly method: "GET";
@@ -807,7 +824,14 @@ interface components {
             expires_at: string;
             /** @description A link into the tenant's app, to edit the change there. It must start with a prefix registered for the environment and pass the link checks (`admin-v1.yaml`, `Connector.deep_link_prefixes`). The runtime removes one that fails, and the proposal is still shown. */
             edit_deep_link?: string;
-        } & (unknown & unknown & unknown & unknown);
+            /** @description v1-draft.18, only once the proposal is `confirmed`: what the tenant saved, as its own setup read says it. Absent before it is applied. The agent says what was saved from it, never what it proposed. */
+            applied?: {
+                /** @description the setup step it belongs to */
+                step?: string;
+                /** @description one line per field saved, in the tenant's words; never a bank or card detail, a document number or a balance, since the agent repeats them to the person */
+                summary: string[];
+            };
+        } & (unknown & unknown & unknown & unknown & unknown);
         /** @description The fields of a booking proposal (topic `booking`, `booking_reschedule` or `booking_cancellation`), whose keys are fixed so every app draws a booking card the same way (`docs/agents-guardrails-suggestions-writes.md` §3.4): `service`, `professional`, `space`, `booking`, `location`, `note` and `reason` are `text`, `services` is a `list`, `time` is a `time_range`, `place` an `address`, and `price`, `deposit`, `fee`, `cancellation_fee` and `refund` are `money_cents`. */
         BookingFields: (unknown & unknown & unknown & unknown & unknown)[];
         /** @description `before` is the current value, absent or null when the proposal creates it, and equal to `after` when the field does not change but says what the change is about (the booking a reschedule moves); `before` and `after` take the shape `type` names. */
@@ -883,9 +907,34 @@ interface components {
             reason?: string;
             /** @description the action's words on its `next_step` card */
             label?: string;
+            /** @description v1-draft.17: whether the step is needed before the business can go live. `false` for a recommended step (payouts), which never stops it; left out, the step counts as required. */
+            required?: boolean;
             /** @description For a step finished on the tenant's own screen, a link into the tenant's app. It must start with a prefix registered for the environment and pass the link checks (`admin-v1.yaml`, `Connector.deep_link_prefixes`). The runtime removes one that fails, and the step is then shown without a card. */
             deep_link?: string;
         } & unknown;
+        /** @description v1-draft.17: the state of the business's own payout account, read under the `payouts` capability (a professional, host or staff subject; the tenant answers for the business of the session's delegated token). Never a bank or card detail, a balance, or a payout amount other than what waits to be paid out. */
+        PayoutAccount: {
+            /**
+             * @description `not_started`: nothing connected yet; `onboarding`: setup begun and not finished; `pending_verification`: the payment provider is reviewing the details; `action_required`: the business must give something more (`missing`); `active`: payouts are sent; `restricted`: payouts are paused by the provider; `rejected`: the account was refused.
+             * @enum {string}
+             */
+            state: "not_started" | "onboarding" | "pending_verification" | "action_required" | "active" | "restricted" | "rejected";
+            /** @description whether the business must act before payouts can be sent */
+            action_required?: boolean;
+            /** @description the codes of the requirements still missing, never the values given for them */
+            missing?: string[];
+            /** @description how fresh the state is, as the tenant names it; `refresh_failed` means the last state known */
+            sync_state?: string;
+            /** @description the tenant's payout screen, under a registered prefix (`admin-v1.yaml`, `Connector.deep_link_prefixes`) */
+            deep_link?: string;
+            /** @description what the business has earned from bookings that waits to be paid out, left out when nothing waits. The tenant returns it only to a subject its own rules let see the business's money (the owner; a staff member only when the tenant allows it), and leaves it out for anyone else; the state stays readable to all */
+            waiting_earnings?: components["schemas"]["Money"];
+            /**
+             * Format: date-time
+             * @description since when the oldest of it waits
+             */
+            waiting_since?: string;
+        };
         /** @description One of the signed-in customer's kits: items a styling-kit retailer sends to try at home, each kept or returned, the kept ones charged. `status` is where the kit is in its life: `preparing` (being put together), `shipped` (on its way), `delivered` (arrived, deciding not open yet), `feedback_open` (the customer decides keep or return for each item, until `feedback_closes_at`), `feedback_closed` (the decisions are in; the items to return are due back by `return_by`), `returned` (the returned items arrived), `billed` (the kept items were charged: `order_id`), `cancelled`. A retailer whose kits skip a state (feedback opens on delivery) never sends it. "What do I still need to do" is answered by `undecided_count` and each item's `decision` before `feedback_closes_at`, and by the items to return and `return_by` after it. */
         Kit: {
             /** @constant */
@@ -1513,6 +1562,19 @@ interface operations {
                             /** Format: date-time */
                             end: string;
                         }[];
+                        /** @description v1-draft.19, the service the times are for */
+                        service_name?: string;
+                        /** @description v1-draft.19, that service's length */
+                        duration_minutes?: number;
+                        /** @description v1-draft.19, true when no service was asked and the tenant took the professional's shortest */
+                        service_assumed?: boolean;
+                        /** @description v1-draft.19, only when `slots` is empty: the first open time the tenant found after the window (it may look up to 60 days ahead); absent when it found none */
+                        next_available?: {
+                            /** Format: date */
+                            date: string;
+                            /** Format: date-time */
+                            start?: string;
+                        };
                     };
                 };
             };
@@ -1908,6 +1970,34 @@ interface operations {
             default: components["responses"]["Problem"];
         };
     };
+    read_proposal: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description on every tool call in a session, a channel session's included (never on the catalogue sweep), the session's id; informational and not signed */
+                "Vinaverse-Session"?: components["parameters"]["VinaverseSession"];
+                /** @description on every tool call of a session that belongs to a conversation (never on the catalogue sweep), its id; informational and not signed */
+                "Vinaverse-Conversation"?: components["parameters"]["VinaverseConversation"];
+            };
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Proposal"];
+                };
+            };
+            default: components["responses"]["Problem"];
+        };
+    };
     get_flow_definition: {
         parameters: {
             query?: {