@augno/sdk 0.14.0 → 0.15.1

package/src/resources/messaging/conversations/conversations.ts

@@ -574,7 +574,16 @@ export interface CreateConversationRequest {
     | 'production_schedule_derived_line'
     | 'production_schedule_settings'
     | 'production_schedule_resource_setting'
+    | 'production_schedule_item_setting'
+    | 'fulfillment_recommendation'
+    | 'analyze_delivery_performance_response'
+    | 'delivery_performance'
+    | 'delivery_backlog_bucket'
+    | 'schedule_order_coverage'
+    | 'schedule_order_coverage_line'
+    | 'promise_date_quote'
     | 'schedule_deviation_type'
+    | 'schedule_at_risk_order'
     | 'production_schedule_finished_policy'
     | 'production_schedule_week_release'
     | 'production_schedule_week_release_preview'
@@ -647,6 +656,7 @@ export interface CreateConversationRequest {
     | 'customer_contact_info'
     | 'customer_freight_preferences'
     | 'customer_defaults'
+    | 'customer_lead_time'
     | 'customer_notification_preferences'
     | 'order_notification_recipient'
     | 'order_discount'
@@ -1405,7 +1415,16 @@ export interface ConversationCreateParams {
     | 'production_schedule_derived_line'
     | 'production_schedule_settings'
     | 'production_schedule_resource_setting'
+    | 'production_schedule_item_setting'
+    | 'fulfillment_recommendation'
+    | 'analyze_delivery_performance_response'
+    | 'delivery_performance'
+    | 'delivery_backlog_bucket'
+    | 'schedule_order_coverage'
+    | 'schedule_order_coverage_line'
+    | 'promise_date_quote'
     | 'schedule_deviation_type'
+    | 'schedule_at_risk_order'
     | 'production_schedule_finished_policy'
     | 'production_schedule_week_release'
     | 'production_schedule_week_release_preview'
@@ -1478,6 +1497,7 @@ export interface ConversationCreateParams {
     | 'customer_contact_info'
     | 'customer_freight_preferences'
     | 'customer_defaults'
+    | 'customer_lead_time'
     | 'customer_notification_preferences'
     | 'order_notification_recipient'
     | 'order_discount'
@@ -1765,7 +1785,16 @@ export interface ConversationListParams {
     | 'production_schedule_derived_line'
     | 'production_schedule_settings'
     | 'production_schedule_resource_setting'
+    | 'production_schedule_item_setting'
+    | 'fulfillment_recommendation'
+    | 'analyze_delivery_performance_response'
+    | 'delivery_performance'
+    | 'delivery_backlog_bucket'
+    | 'schedule_order_coverage'
+    | 'schedule_order_coverage_line'
+    | 'promise_date_quote'
     | 'schedule_deviation_type'
+    | 'schedule_at_risk_order'
     | 'production_schedule_finished_policy'
     | 'production_schedule_week_release'
     | 'production_schedule_week_release_preview'
@@ -1838,6 +1867,7 @@ export interface ConversationListParams {
     | 'customer_contact_info'
     | 'customer_freight_preferences'
     | 'customer_defaults'
+    | 'customer_lead_time'
     | 'customer_notification_preferences'
     | 'order_notification_recipient'
     | 'order_discount'

package/src/resources/messaging/conversations/links.ts

@@ -208,7 +208,16 @@ export interface AddConversationLinkRequest {
     | 'production_schedule_derived_line'
     | 'production_schedule_settings'
     | 'production_schedule_resource_setting'
+    | 'production_schedule_item_setting'
+    | 'fulfillment_recommendation'
+    | 'analyze_delivery_performance_response'
+    | 'delivery_performance'
+    | 'delivery_backlog_bucket'
+    | 'schedule_order_coverage'
+    | 'schedule_order_coverage_line'
+    | 'promise_date_quote'
     | 'schedule_deviation_type'
+    | 'schedule_at_risk_order'
     | 'production_schedule_finished_policy'
     | 'production_schedule_week_release'
     | 'production_schedule_week_release_preview'
@@ -281,6 +290,7 @@ export interface AddConversationLinkRequest {
     | 'customer_contact_info'
     | 'customer_freight_preferences'
     | 'customer_defaults'
+    | 'customer_lead_time'
     | 'customer_notification_preferences'
     | 'order_notification_recipient'
     | 'order_discount'
@@ -562,7 +572,16 @@ export interface LinkCreateParams {
     | 'production_schedule_derived_line'
     | 'production_schedule_settings'
     | 'production_schedule_resource_setting'
+    | 'production_schedule_item_setting'
+    | 'fulfillment_recommendation'
+    | 'analyze_delivery_performance_response'
+    | 'delivery_performance'
+    | 'delivery_backlog_bucket'
+    | 'schedule_order_coverage'
+    | 'schedule_order_coverage_line'
+    | 'promise_date_quote'
     | 'schedule_deviation_type'
+    | 'schedule_at_risk_order'
     | 'production_schedule_finished_policy'
     | 'production_schedule_week_release'
     | 'production_schedule_week_release_preview'
@@ -635,6 +654,7 @@ export interface LinkCreateParams {
     | 'customer_contact_info'
     | 'customer_freight_preferences'
     | 'customer_defaults'
+    | 'customer_lead_time'
     | 'customer_notification_preferences'
     | 'order_notification_recipient'
     | 'order_discount'

package/src/resources/messaging/conversations/messages.ts

@@ -359,7 +359,16 @@ export interface SendMessageRequest {
     | 'production_schedule_derived_line'
     | 'production_schedule_settings'
     | 'production_schedule_resource_setting'
+    | 'production_schedule_item_setting'
+    | 'fulfillment_recommendation'
+    | 'analyze_delivery_performance_response'
+    | 'delivery_performance'
+    | 'delivery_backlog_bucket'
+    | 'schedule_order_coverage'
+    | 'schedule_order_coverage_line'
+    | 'promise_date_quote'
     | 'schedule_deviation_type'
+    | 'schedule_at_risk_order'
     | 'production_schedule_finished_policy'
     | 'production_schedule_week_release'
     | 'production_schedule_week_release_preview'
@@ -432,6 +441,7 @@ export interface SendMessageRequest {
     | 'customer_contact_info'
     | 'customer_freight_preferences'
     | 'customer_defaults'
+    | 'customer_lead_time'
     | 'customer_notification_preferences'
     | 'order_notification_recipient'
     | 'order_discount'
@@ -776,7 +786,16 @@ export interface MessageCreateParams {
     | 'production_schedule_derived_line'
     | 'production_schedule_settings'
     | 'production_schedule_resource_setting'
+    | 'production_schedule_item_setting'
+    | 'fulfillment_recommendation'
+    | 'analyze_delivery_performance_response'
+    | 'delivery_performance'
+    | 'delivery_backlog_bucket'
+    | 'schedule_order_coverage'
+    | 'schedule_order_coverage_line'
+    | 'promise_date_quote'
     | 'schedule_deviation_type'
+    | 'schedule_at_risk_order'
     | 'production_schedule_finished_policy'
     | 'production_schedule_week_release'
     | 'production_schedule_week_release_preview'
@@ -849,6 +868,7 @@ export interface MessageCreateParams {
     | 'customer_contact_info'
     | 'customer_freight_preferences'
     | 'customer_defaults'
+    | 'customer_lead_time'
     | 'customer_notification_preferences'
     | 'order_notification_recipient'
     | 'order_discount'

package/src/resources/messaging/notifications/notifications.ts

@@ -589,7 +589,16 @@ export interface SendNotificationRequest {
     | 'production_schedule_derived_line'
     | 'production_schedule_settings'
     | 'production_schedule_resource_setting'
+    | 'production_schedule_item_setting'
+    | 'fulfillment_recommendation'
+    | 'analyze_delivery_performance_response'
+    | 'delivery_performance'
+    | 'delivery_backlog_bucket'
+    | 'schedule_order_coverage'
+    | 'schedule_order_coverage_line'
+    | 'promise_date_quote'
     | 'schedule_deviation_type'
+    | 'schedule_at_risk_order'
     | 'production_schedule_finished_policy'
     | 'production_schedule_week_release'
     | 'production_schedule_week_release_preview'
@@ -662,6 +671,7 @@ export interface SendNotificationRequest {
     | 'customer_contact_info'
     | 'customer_freight_preferences'
     | 'customer_defaults'
+    | 'customer_lead_time'
     | 'customer_notification_preferences'
     | 'order_notification_recipient'
     | 'order_discount'
@@ -919,7 +929,16 @@ export interface NotificationCreateParams {
     | 'production_schedule_derived_line'
     | 'production_schedule_settings'
     | 'production_schedule_resource_setting'
+    | 'production_schedule_item_setting'
+    | 'fulfillment_recommendation'
+    | 'analyze_delivery_performance_response'
+    | 'delivery_performance'
+    | 'delivery_backlog_bucket'
+    | 'schedule_order_coverage'
+    | 'schedule_order_coverage_line'
+    | 'promise_date_quote'
     | 'schedule_deviation_type'
+    | 'schedule_at_risk_order'
     | 'production_schedule_finished_policy'
     | 'production_schedule_week_release'
     | 'production_schedule_week_release_preview'
@@ -992,6 +1011,7 @@ export interface NotificationCreateParams {
     | 'customer_contact_info'
     | 'customer_freight_preferences'
     | 'customer_defaults'
+    | 'customer_lead_time'
     | 'customer_notification_preferences'
     | 'order_notification_recipient'
     | 'order_discount'

package/src/resources/operations/carriers/service-levels.ts

@@ -81,6 +81,7 @@ export class ServiceLevels extends APIResource {
    *       is_default: false,
    *       name: 'Ground Shipping',
    *       customer_portal_visibility: 'visible',
+   *       default_transit_days: 3,
    *     },
    *   );
    * ```
@@ -195,6 +196,16 @@ export interface CreateServiceLevelRequest {
    * customer portal.
    */
   customer_portal_visibility?: 'visible' | 'hidden';
+
+  /**
+   * Business days this service typically takes in transit, used to work an order's
+   * ship-by date back from a promised delivery date.
+   *
+   * A fallback: when a carrier can rate the lane, the transit it quotes is used
+   * instead. Leave unset for carriers that can be rated, and set it for those that
+   * cannot (freight, will-call), where it is the only transit the system will have.
+   */
+  default_transit_days?: number;
 }
 
 /**
@@ -217,6 +228,16 @@ export interface UpdateServiceLevelRequest {
    */
   customer_portal_visibility?: 'visible' | 'hidden';
 
+  /**
+   * Business days this service typically takes in transit, used to work an order's
+   * ship-by date back from a promised delivery date.
+   *
+   * A fallback: when a carrier can rate the lane, the transit it quotes is used
+   * instead. Set to null to remove it, which leaves transit unknown for lanes the
+   * carrier cannot rate.
+   */
+  default_transit_days?: number | null;
+
   /**
    * Whether this is the carrier's default service level, pre-selected when the
    * carrier is chosen.
@@ -313,6 +334,16 @@ export interface ServiceLevelCreateParams {
    * in the customer portal.
    */
   customer_portal_visibility?: 'visible' | 'hidden';
+
+  /**
+   * Body param: Business days this service typically takes in transit, used to work
+   * an order's ship-by date back from a promised delivery date.
+   *
+   * A fallback: when a carrier can rate the lane, the transit it quotes is used
+   * instead. Leave unset for carriers that can be rated, and set it for those that
+   * cannot (freight, will-call), where it is the only transit the system will have.
+   */
+  default_transit_days?: number;
 }
 
 export interface ServiceLevelUpdateParams {
@@ -344,6 +375,16 @@ export interface ServiceLevelUpdateParams {
    */
   customer_portal_visibility?: 'visible' | 'hidden';
 
+  /**
+   * Body param: Business days this service typically takes in transit, used to work
+   * an order's ship-by date back from a promised delivery date.
+   *
+   * A fallback: when a carrier can rate the lane, the transit it quotes is used
+   * instead. Set to null to remove it, which leaves transit unknown for lanes the
+   * carrier cannot rate.
+   */
+  default_transit_days?: number | null;
+
   /**
    * Body param: Whether this is the carrier's default service level, pre-selected
    * when the carrier is chosen.

package/src/resources/operations/fulfillment-recommendations/actions.ts

@@ -0,0 +1,75 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as FulfillmentRecommendationsAPI from './fulfillment-recommendations';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+/**
+ * The planning assumptions production schedules are solved against, and the per-resource overrides that mark which machines constrain the plan.
+ */
+export class Actions extends APIResource {
+  /**
+   * Adopts the recommended fulfillment policy for the named items, writing it as a
+   * per-item planning override.
+   *
+   * The recommendation is recomputed as part of applying it, rather than taken from
+   * the request. Advice read minutes ago may no longer be the advice — demand moves
+   * — and writing a stale verdict would set a policy the engine would not give
+   * today. What comes back is what was actually written.
+   *
+   * Takes effect on the next generated schedule; versions already generated keep the
+   * assumptions they were solved under.
+   *
+   * This endpoint requires the permission: `production_schedules:update`.
+   *
+   * @example
+   * ```ts
+   * const listFulfillmentRecommendation =
+   *   await client.operations.fulfillmentRecommendations.actions.apply(
+   *     { item_ids: ['it_pej07ckhvu62'] },
+   *   );
+   * ```
+   */
+  apply(
+    body: ActionApplyParams,
+    options?: RequestOptions,
+  ): APIPromise<FulfillmentRecommendationsAPI.ListFulfillmentRecommendation> {
+    return this._client.post('/v1/operations/fulfillment-recommendations/actions/apply', {
+      body,
+      ...options,
+    });
+  }
+}
+
+/**
+ * Request to adopt fulfillment recommendations for specific items.
+ */
+export interface ApplyFulfillmentRecommendationsRequest {
+  /**
+   * Items whose recommendation should be adopted.
+   *
+   * Named explicitly rather than applied wholesale: adopting advice in bulk without
+   * saying what is being adopted is how a plant changes what it builds by accident.
+   * Items not named here are left exactly as they are.
+   */
+  item_ids: Array<string>;
+}
+
+export interface ActionApplyParams {
+  /**
+   * Items whose recommendation should be adopted.
+   *
+   * Named explicitly rather than applied wholesale: adopting advice in bulk without
+   * saying what is being adopted is how a plant changes what it builds by accident.
+   * Items not named here are left exactly as they are.
+   */
+  item_ids: Array<string>;
+}
+
+export declare namespace Actions {
+  export {
+    type ApplyFulfillmentRecommendationsRequest as ApplyFulfillmentRecommendationsRequest,
+    type ActionApplyParams as ActionApplyParams,
+  };
+}

package/src/resources/operations/fulfillment-recommendations/fulfillment-recommendations.ts

@@ -0,0 +1,206 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as CoreAPI from '../../core/core';
+import * as APIKeysAPI from '../../auth/api-keys/api-keys';
+import * as ActionsAPI from './actions';
+import { ActionApplyParams, Actions, ApplyFulfillmentRecommendationsRequest } from './actions';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+/**
+ * The planning assumptions production schedules are solved against, and the per-resource overrides that mark which machines constrain the plan.
+ */
+export class FulfillmentRecommendations extends APIResource {
+  actions: ActionsAPI.Actions = new ActionsAPI.Actions(this._client);
+
+  /**
+   * Returns, for every sellable SKU, whether it should be built to stock or only
+   * against orders — and the measurement that decided.
+   *
+   * The rules are ordered and the first match wins. Lead-time feasibility is checked
+   * before anything else: if customers are promised less time than production needs,
+   * building to order is not possible rather than not preferred, and no amount of
+   * lumpy demand changes that. After that the engine looks for dead stock, a single
+   * contract customer, demand too erratic for a buffer to size, and slow-moving
+   * expensive units.
+   *
+   * Every verdict carries its numbers — demand interval, variability, customer
+   * concentration, promised lead time, annual cost of goods — so a planner can
+   * disagree with the rule rather than only with the answer. Thresholds are
+   * merchant-editable in the planning settings.
+   *
+   * Computed fresh on every call rather than stored. A recommendation is only
+   * meaningful next to current demand, and a saved one would go quietly stale; the
+   * durable artifact is the item setting written when someone agrees with it.
+   * Nothing here changes a plan on its own.
+   *
+   * This endpoint requires the permission: `production_schedules:read`.
+   *
+   * @example
+   * ```ts
+   * const listFulfillmentRecommendation =
+   *   await client.operations.fulfillmentRecommendations.list();
+   * ```
+   */
+  list(options?: RequestOptions): APIPromise<ListFulfillmentRecommendation> {
+    return this._client.get('/v1/operations/fulfillment-recommendations', options);
+  }
+}
+
+/**
+ * The engine's advice on how one SKU should be produced, with the measurements
+ * behind it.
+ */
+export interface FulfillmentRecommendation {
+  /**
+   * Annual cost of goods for this item: demand times unit cost.
+   */
+  annual_cogs: number;
+
+  /**
+   * Months observed divided by months with demand: 1 means it sells every month, 3
+   * means once a quarter on average.
+   *
+   * Measured on monthly buckets, which cannot distinguish two orders in one month
+   * from one.
+   */
+  average_demand_interval: number;
+
+  /**
+   * Whether adopting the recommendation would change anything.
+   */
+  changes: boolean;
+
+  /**
+   * Squared coefficient of variation over the months that had demand, measuring how
+   * uneven the quantities are.
+   */
+  coefficient_of_variation: number;
+
+  /**
+   * How the item is planned today.
+   */
+  current_policy: 'make_to_stock' | 'make_to_order';
+
+  /**
+   * Calendar days customers are promised on average, weighted by how much each buys.
+   */
+  demand_weighted_lead_time_days: number;
+
+  /**
+   * Entity is a polymorphic reference to any resource in the system.
+   */
+  item: CoreAPI.Entity | null;
+
+  /**
+   * Percentage of demand from customers whose own stated policy disagrees with the
+   * recommendation.
+   *
+   * A policy is resolved per SKU, so an item sold to both a stocking distributor and
+   * a contract customer gets one answer either way. A high share here is the signal
+   * that the single answer is uncomfortable.
+   */
+  mixed_stream_share_pct: number;
+
+  /**
+   * Months since anything last sold, capped at the observation window.
+   */
+  months_since_last_sale: number;
+
+  /**
+   * Resource type identifier.
+   */
+  object: 'fulfillment_recommendation';
+
+  /**
+   * Entity is a polymorphic reference to any resource in the system.
+   */
+  product_line: CoreAPI.Entity | null;
+
+  /**
+   * The rule that decided.
+   *
+   * - `lead_time_infeasible`: customers are promised less time than production
+   *   needs, so the stock has to exist before the order does. Checked first, because
+   *   producing to order is not possible rather than not preferred.
+   * - `no_recent_demand`: nothing has sold for long enough that a buffer is dead
+   *   stock.
+   * - `single_customer`: effectively one customer buys it, and that customer is
+   *   served to order.
+   * - `lumpy_demand`: demand arrives rarely and in wildly different sizes, which is
+   *   the shape a safety stock sizes worst.
+   * - `slow_moving_high_value`: expensive units, few sold — the buffer costs more
+   *   than the service it buys.
+   * - `steady_demand`: regular enough to forecast, which is what stocking is for.
+   */
+  reason:
+    | 'lead_time_infeasible'
+    | 'no_recent_demand'
+    | 'single_customer'
+    | 'lumpy_demand'
+    | 'slow_moving_high_value'
+    | 'steady_demand';
+
+  /**
+   * How the engine thinks it should be planned.
+   */
+  recommended_policy: 'make_to_stock' | 'make_to_order';
+
+  /**
+   * SKU of that item.
+   */
+  sku: string;
+
+  /**
+   * Name of that customer.
+   */
+  top_customer_name: string | null;
+
+  /**
+   * The largest customer's share of this item's demand, as a percentage.
+   */
+  top_customer_share_pct: number;
+}
+
+/**
+ * A single page of resources, together with the metadata needed to page through
+ * the rest of the result set.
+ */
+export interface ListFulfillmentRecommendation {
+  /**
+   * Resources in this page.
+   */
+  data: Array<FulfillmentRecommendation>;
+
+  /**
+   * Resource type identifier.
+   */
+  object: 'list';
+
+  /**
+   * PageInfo describes where the current page sits within a paginated result set and
+   * how to move to the adjacent pages.
+   *
+   * Page a list by following the URLs below rather than assembling cursors yourself.
+   * For a top-level list endpoint the URL repeats the original request's query
+   * string with only the cursor swapped, so following it preserves the same filters,
+   * search term, and page size.
+   */
+  page_info: APIKeysAPI.PageInfo;
+}
+
+FulfillmentRecommendations.Actions = Actions;
+
+export declare namespace FulfillmentRecommendations {
+  export {
+    type FulfillmentRecommendation as FulfillmentRecommendation,
+    type ListFulfillmentRecommendation as ListFulfillmentRecommendation,
+  };
+
+  export {
+    Actions as Actions,
+    type ApplyFulfillmentRecommendationsRequest as ApplyFulfillmentRecommendationsRequest,
+    type ActionApplyParams as ActionApplyParams,
+  };
+}

package/src/resources/operations/fulfillment-recommendations/index.ts

@@ -0,0 +1,8 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Actions, type ApplyFulfillmentRecommendationsRequest, type ActionApplyParams } from './actions';
+export {
+  FulfillmentRecommendations,
+  type FulfillmentRecommendation,
+  type ListFulfillmentRecommendation,
+} from './fulfillment-recommendations';

package/src/resources/operations/fulfillment-recommendations.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './fulfillment-recommendations/index';

package/src/resources/operations/index.ts

@@ -35,6 +35,11 @@ export {
   type DepartmentCreateParams,
   type DepartmentUpdateParams,
 } from './departments';
+export {
+  FulfillmentRecommendations,
+  type FulfillmentRecommendation,
+  type ListFulfillmentRecommendation,
+} from './fulfillment-recommendations/index';
 export {
   LocationTypes,
   type ListLocationType,
@@ -104,6 +109,9 @@ export {
   type ListReleaseScheduleBatch,
   type ListReleasedScheduleLine,
   type ListScheduleAppliedOverride,
+  type ListScheduleAtRiskOrder,
+  type ListScheduleOrderCoverage,
+  type ListScheduleOrderCoverageLine,
   type ProductionSchedule,
   type ProductionScheduleDerivedLine,
   type ProductionScheduleDeviation,
@@ -113,7 +121,10 @@ export {
   type ReleaseScheduleWeekPreview,
   type ReleasedScheduleLine,
   type ScheduleAppliedOverride,
+  type ScheduleAtRiskOrder,
   type ScheduleDiagnostics,
+  type ScheduleOrderCoverage,
+  type ScheduleOrderCoverageLine,
   type ProductionScheduleDeleteResponse,
   type ProductionScheduleListParams,
   type ProductionScheduleCreateParams,