@oneshot-agent/sdk 0.54.0 → 0.56.0

package/dist/predict-input.generated.d.ts

@@ -0,0 +1,59 @@
+export type PredictInput = {
+    model: "simulation";
+    simulation: {
+        variables: {
+            id: string;
+            distribution: {
+                value: number;
+                kind: "fixed";
+            } | {
+                kind: "uniform";
+                min: number;
+                max: number;
+            } | {
+                kind: "normal";
+                mean: number;
+                sd: number;
+            } | {
+                kind: "lognormal";
+                log_mean: number;
+                log_sd: number;
+            } | {
+                kind: "triangular";
+                min: number;
+                max: number;
+                mode: number;
+            } | {
+                kind: "bernoulli";
+                p: number;
+            } | {
+                values: number[];
+                kind: "discrete";
+                weights?: number[] | undefined;
+            };
+        }[];
+        outputs: {
+            id: string;
+            expression: string;
+        }[];
+        runs?: number | undefined;
+        seed?: number | undefined;
+        percentiles?: number[] | undefined;
+    };
+    time_limit_s?: number | undefined;
+} | {
+    model: "forecast";
+    forecast: {
+        series: {
+            t: string | number;
+            y: number;
+        }[];
+        horizon: number;
+        frequency?: "hourly" | "daily" | "weekly" | "monthly" | "quarterly" | "yearly" | undefined;
+        seasonal_period?: number | undefined;
+        interval_levels?: number[] | undefined;
+        floor?: number | undefined;
+    };
+    time_limit_s?: number | undefined;
+};
+//# sourceMappingURL=predict-input.generated.d.ts.map

package/dist/predict-input.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predict-input.generated.d.ts","sourceRoot":"","sources":["../src/predict-input.generated.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,YAAY,GAAG;IACvB,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE;QACR,SAAS,EAAE;YACP,EAAE,EAAE,MAAM,CAAC;YACX,YAAY,EAAE;gBACV,KAAK,EAAE,MAAM,CAAC;gBACd,IAAI,EAAE,OAAO,CAAC;aACjB,GAAG;gBACA,IAAI,EAAE,SAAS,CAAC;gBAChB,GAAG,EAAE,MAAM,CAAC;gBACZ,GAAG,EAAE,MAAM,CAAC;aACf,GAAG;gBACA,IAAI,EAAE,QAAQ,CAAC;gBACf,IAAI,EAAE,MAAM,CAAC;gBACb,EAAE,EAAE,MAAM,CAAC;aACd,GAAG;gBACA,IAAI,EAAE,WAAW,CAAC;gBAClB,QAAQ,EAAE,MAAM,CAAC;gBACjB,MAAM,EAAE,MAAM,CAAC;aAClB,GAAG;gBACA,IAAI,EAAE,YAAY,CAAC;gBACnB,GAAG,EAAE,MAAM,CAAC;gBACZ,GAAG,EAAE,MAAM,CAAC;gBACZ,IAAI,EAAE,MAAM,CAAC;aAChB,GAAG;gBACA,IAAI,EAAE,WAAW,CAAC;gBAClB,CAAC,EAAE,MAAM,CAAC;aACb,GAAG;gBACA,MAAM,EAAE,MAAM,EAAE,CAAC;gBACjB,IAAI,EAAE,UAAU,CAAC;gBACjB,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;aAClC,CAAC;SACL,EAAE,CAAC;QACJ,OAAO,EAAE;YACL,EAAE,EAAE,MAAM,CAAC;YACX,UAAU,EAAE,MAAM,CAAC;SACtB,EAAE,CAAC;QACJ,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;KACtC,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,GAAG;IACA,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE;QACN,MAAM,EAAE;YACJ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;YACnB,CAAC,EAAE,MAAM,CAAC;SACb,EAAE,CAAC;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;QAC3F,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACrC,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QACvC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,CAAC"}

package/dist/predict-input.generated.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=predict-input.generated.js.map

package/dist/predict-input.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predict-input.generated.js","sourceRoot":"","sources":["../src/predict-input.generated.ts"],"names":[],"mappings":""}

package/dist/predict.d.ts

@@ -0,0 +1,97 @@
+import type { ToolOptions } from './types';
+import type { PredictInput } from './predict-input.generated';
+export type { PredictInput } from './predict-input.generated';
+/** Transport options are accepted; receipt metadata is not supported. */
+export type PredictOptions = PredictInput & Omit<ToolOptions, 'memo' | 'valueTag' | 'decisionContext'>;
+export type PredictModel = PredictInput['model'];
+/** Durable job handle returned when Predict is submitted with wait: false. */
+export type PredictPendingResult = {
+    status: 'pending' | 'processing';
+    request_id: string;
+    receipt_id?: string;
+    idempotencyKey: string;
+};
+type PredictMeta<M extends PredictModel> = {
+    model: M;
+    version: string;
+    size: number;
+    size_band: 'small' | 'medium' | 'large';
+    time_limit_s: number;
+    run_time_s: number;
+};
+type PredictBase<M extends PredictModel> = {
+    model: M;
+    version: string;
+    status: 'complete' | 'timeout';
+    checks: Array<{
+        name: string;
+        passed: boolean;
+        detail: string;
+    }>;
+};
+export type PredictSimulationResult = PredictBase<'simulation'> & {
+    prediction: {
+        outputs: Array<{
+            id: string;
+            mean: number;
+            median: number;
+        }>;
+    } | null;
+    uncertainty: {
+        outputs: Array<{
+            id: string;
+            sd: number;
+            mean_standard_error: number;
+            min: number;
+            max: number;
+            percentiles: Array<{
+                p: number;
+                value: number;
+            }>;
+        }>;
+    } | null;
+    meta: PredictMeta<'simulation'> & {
+        seed: number;
+        runs_requested: number;
+        runs_completed: number;
+        runs_discarded: number;
+        runs_kept: number;
+    };
+};
+export type PredictForecastResult = PredictBase<'forecast'> & {
+    prediction: {
+        points: Array<{
+            t: string | number;
+            value: number;
+        }>;
+    };
+    uncertainty: {
+        intervals: Array<{
+            level: number;
+            points: Array<{
+                t: string | number;
+                lower: number;
+                upper: number;
+            }>;
+        }>;
+    };
+    meta: PredictMeta<'forecast'> & {
+        method: string;
+        series_length: number;
+        gaps_filled: number;
+        frequency: NonNullable<Extract<PredictInput, {
+            model: 'forecast';
+        }>['forecast']['frequency']> | null;
+        seasonal_period: number | null;
+        horizon: number;
+        candidates_tried: number;
+        backtest: {
+            holdout_points: number;
+            mae: number;
+            rmse: number;
+        };
+    };
+};
+export type PredictResultFor<M extends PredictModel> = M extends 'simulation' ? PredictSimulationResult : PredictForecastResult;
+export type PredictResult = PredictResultFor<PredictModel>;
+//# sourceMappingURL=predict.d.ts.map

package/dist/predict.d.ts.map

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

package/dist/predict.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=predict.js.map

package/dist/predict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predict.js","sourceRoot":"","sources":["../src/predict.ts"],"names":[],"mappings":""}

package/dist/solve-input.generated.d.ts

@@ -0,0 +1,143 @@
+export type SolveInput = {
+    problem: "routing";
+    routing: {
+        objective: "distance" | "time" | "vehicles";
+        vehicles: {
+            id: string;
+            capacity: number;
+            start: {
+                id: string;
+            } | {
+                lat: number;
+                lng: number;
+            };
+            shift?: {
+                start: number;
+                end: number;
+            } | undefined;
+            end?: {
+                id: string;
+            } | {
+                lat: number;
+                lng: number;
+            } | undefined;
+        }[];
+        stops: {
+            id: string;
+            location: {
+                id: string;
+            } | {
+                lat: number;
+                lng: number;
+            };
+            demand?: number | undefined;
+            window?: {
+                start: number;
+                end: number;
+            } | undefined;
+            service_time?: number | undefined;
+        }[];
+        distance_unit?: string | undefined;
+        time_unit?: string | undefined;
+        speed?: number | undefined;
+        matrix?: {
+            ids: string[];
+            distance?: number[][] | undefined;
+            time?: number[][] | undefined;
+        } | undefined;
+    };
+    time_limit_s?: number | undefined;
+} | {
+    problem: "allocation";
+    allocation: {
+        options: {
+            id: string;
+            capacity?: number | undefined;
+        }[];
+        objective: "minimise_cost" | "maximise_value";
+        items: {
+            id: string;
+            quantity?: number | undefined;
+        }[];
+        pairs: {
+            item: string;
+            option: string;
+            cost: number;
+            value?: number | undefined;
+        }[];
+        split?: boolean | undefined;
+        max_total_cost?: number | undefined;
+        min_share?: {
+            option: string;
+            share: number;
+            item?: string | undefined;
+            if_used?: boolean | undefined;
+        }[] | undefined;
+        max_share?: {
+            option: string;
+            share: number;
+            item?: string | undefined;
+        }[] | undefined;
+        required?: {
+            item: string;
+            option: string;
+        }[] | undefined;
+        forbidden?: {
+            item: string;
+            option: string;
+        }[] | undefined;
+    };
+    time_limit_s?: number | undefined;
+} | {
+    problem: "packing";
+    packing: {
+        items: {
+            id: string;
+            size: Record<string, number>;
+            value?: number | undefined;
+            quantity?: number | undefined;
+        }[];
+        variant: "bin" | "knapsack";
+        dimensions: string[];
+        bins: {
+            id: string;
+            capacity: Record<string, number>;
+            quantity?: number | undefined;
+        }[];
+        incompatible?: [
+            string,
+            string
+        ][] | undefined;
+    };
+    time_limit_s?: number | undefined;
+} | {
+    problem: "schedule";
+    schedule: {
+        objective: "cost" | "makespan" | "tardiness";
+        jobs: {
+            id: string;
+            duration: number;
+            release?: number | undefined;
+            due?: number | undefined;
+            needs?: unknown;
+            weight?: number | undefined;
+        }[];
+        resources: {
+            id: string;
+            capacity: number;
+            calendar?: {
+                start: number;
+                end: number;
+            }[] | undefined;
+            cost_per_unit_time?: number | undefined;
+        }[];
+        time_unit?: string | undefined;
+        precedence?: {
+            before: string;
+            after: string;
+            lag?: number | undefined;
+        }[] | undefined;
+    };
+    time_limit_s?: number | undefined;
+};
+//# sourceMappingURL=solve-input.generated.d.ts.map

package/dist/solve-input.generated.d.ts.map

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

package/dist/solve-input.generated.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=solve-input.generated.js.map

package/dist/solve-input.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solve-input.generated.js","sourceRoot":"","sources":["../src/solve-input.generated.ts"],"names":[],"mappings":""}

package/dist/solve.d.ts

@@ -0,0 +1,129 @@
+import type { ToolOptions } from './types';
+import type { SolveInput } from './solve-input.generated';
+export type { SolveInput } from './solve-input.generated';
+/** Solve accepts transport options, but does not support receipt metadata. */
+export type SolveOptions = SolveInput & Omit<ToolOptions, 'memo' | 'valueTag' | 'decisionContext'>;
+export type SolveProblem = SolveInput['problem'];
+/** `solution` of a `routing` result, as specified in docs/design/solve.md section 3. */
+export interface SolveRoutingSolution {
+    routes: Array<{
+        vehicle: string;
+        stops: Array<{
+            id: string;
+            arrival: number;
+            departure: number;
+            load_after: number;
+        }>;
+        distance: number;
+        time: number;
+    }>;
+    unserved: string[];
+}
+/** `solution` of an `allocation` result, as specified in docs/design/solve.md. */
+export interface SolveAllocationSolution {
+    assignments: Array<{
+        item: string;
+        option: string;
+        quantity: number;
+        fraction: number;
+        cost: number;
+        value: number | null;
+    }>;
+    per_option: Array<{
+        option: string;
+        quantity: number;
+        share: number;
+        cost: number;
+        value: number | null;
+    }>;
+    unassigned: Array<{
+        item: string;
+        quantity: number;
+    }>;
+}
+/** `solution` of a `packing` result; `left_out` is present for the `knapsack` variant only. */
+export interface SolvePackingSolution {
+    bins: Array<{
+        bin: string;
+        index: number;
+        items: Array<{
+            id: string;
+            count: number;
+        }>;
+        used: Record<string, number>;
+    }>;
+    left_out?: Array<{
+        id: string;
+        count: number;
+    }>;
+}
+/** `solution` of a `schedule` result: each job's start, end, resource allocation and lateness. */
+export interface SolveScheduleSolution {
+    starts: Array<{
+        job: string;
+        start: number;
+        end: number;
+        resources: Record<string, number>;
+        tardiness: number;
+    }>;
+    makespan: number;
+}
+/** The solution shape per problem. Adding a problem is one entry here (and its `SolveInput` variant). */
+export interface SolveSolutions {
+    routing: SolveRoutingSolution;
+    allocation: SolveAllocationSolution;
+    packing: SolvePackingSolution;
+    schedule: SolveScheduleSolution;
+}
+/** Completed job result for exactly one problem, as specified in docs/design/solve.md. */
+export interface SolveProblemResult<P extends SolveProblem> {
+    status: 'optimal' | 'feasible' | 'infeasible' | 'timeout';
+    objective_value: number | null;
+    bound: number | null;
+    gap: number | null;
+    solution: SolveSolutions[P] | null;
+    checks: Array<{
+        name: string;
+        satisfied: boolean;
+        worst_violation: number;
+        detail: string;
+    }>;
+    conflicts: Array<{
+        constraints: Array<{
+            family: string;
+            ref: string;
+            label: string;
+        }>;
+        explanation: string;
+    }>;
+    meta: {
+        problem: P;
+        size: Record<string, number>;
+        variables_estimated: number;
+        variables_built: number;
+        solve_time_s: number;
+        time_limit_s: number;
+        conflicts_complete: boolean | null;
+    };
+}
+/**
+ * Completed job result for the problem(s) in `P`. A union of problems distributes into one correlated
+ * variant per problem (`meta.problem` and `solution` agree), so a request typed as the whole `SolveInput`
+ * union yields a `SolveResult`, never one object with independent unions.
+ */
+export type SolveResultFor<P extends SolveProblem> = P extends SolveProblem ? SolveProblemResult<P> : never;
+/** Completed job result, discriminated by `meta.problem`: it narrows `solution` to the problem's shape. */
+export type SolveResult = SolveResultFor<SolveProblem>;
+/** `P` when it names exactly one problem, `never` when it is a union of problems. */
+type SingleProblem<P extends SolveProblem, Each = P> = P extends unknown ? ([Each] extends [P] ? P : never) : never;
+/**
+ * Narrows a `SolveResult` to one problem's result. TypeScript does not narrow a union through a nested
+ * check such as `result.meta.problem === 'packing'`, so a caller holding a `SolveResult` uses this guard.
+ *
+ * Only a single literal problem narrows. For a problem chosen at runtime (typed as a union of problems)
+ * the guard is a plain boolean: a type predicate for the whole union would make the reachable false
+ * branch `never`.
+ */
+export declare function isSolveResultFor<P extends SolveProblem>(result: SolveResult, problem: SingleProblem<P>): result is SolveResultFor<P>;
+export declare function isSolveResultFor(result: SolveResult, problem: SolveProblem): boolean;
+//# sourceMappingURL=solve.d.ts.map

package/dist/solve.d.ts.map

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

package/dist/solve.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSolveResultFor = isSolveResultFor;
+function isSolveResultFor(result, problem) {
+    return result.meta.problem === problem;
+}
+//# sourceMappingURL=solve.js.map

package/dist/solve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solve.js","sourceRoot":"","sources":["../src/solve.ts"],"names":[],"mappings":";;AAkGA,4CAEC;AAFD,SAAgB,gBAAgB,CAAC,MAAmB,EAAE,OAAqB;IACzE,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC;AACzC,CAAC"}

package/dist/types.d.ts

@@ -45,6 +45,12 @@ export interface PaymentAuthorization {
     };
 }
 export type LoggerFn = (message: string) => void;
+/**
+ * Observes the first status and subsequent changes, including completed/failed
+ * before the job wait settles. Status strings are passed through from the API.
+ * With waitForPhones, completed is deferred until the optional phone wait returns.
+ * Throws and rejected promises are ignored. Async callbacks are not awaited.
+ */
 export type StatusUpdateFn = (status: string, requestId: string) => void;
 export interface OneShotConfig {
     /** Option A: Raw private key (existing behavior) */
@@ -353,13 +359,33 @@ export interface PersonFindOptions extends ToolOptions {
      * regardless of which provider answers the search. */
     offset?: number;
 }
-export interface PersonProfileOptions extends ToolOptions {
+/**
+ * What a caller knows about one person (#1899). Every single-person tool takes
+ * these same optional fields; at least one of `name`, `email`, `phone` or
+ * `profile_url` is required. The API resolves the rest (a LinkedIn URL from a
+ * name and company or an email, the other handles, the employer).
+ */
+export interface PersonIdentity {
+    /** Full name. Works best with `company`. */
+    name?: string;
+    /** Employer name or domain, e.g. `'Coinbase'` or `'coinbase.com'`. */
+    company?: string;
+    email?: string;
+    phone?: string;
+    /** Profile URL on LinkedIn, X or GitHub. */
+    profile_url?: string;
+    /** Same as `profile_url` (older name). */
+    linkedin_url?: string;
+    /** Same as `profile_url` (older name). */
+    social_media_url?: string;
+}
+export interface PersonProfileOptions extends ToolOptions, PersonIdentity {
     /** Off by default. Adds the per-person add-on on the pricing page for up to one person; no phone hit guaranteed. */
     includePhone?: boolean;
-    linkedin_url?: string;
-    email?: string;
-    name?: string;
+    /** Employer domain (older name; `company` takes a name or a domain). */
     company_domain?: string;
+    /** Employer name (older name; `company` takes a name or a domain). */
+    company_name?: string;
 }
 export interface CompanyFindOptions extends ToolOptions {
     name?: string;
@@ -379,26 +405,24 @@ export interface CompanyProfileOptions extends ToolOptions {
     linkedin_url?: string;
     ticker?: string;
 }
-export interface PersonEmailOptions extends ToolOptions {
+export interface PersonEmailOptions extends ToolOptions, PersonIdentity {
+    /** Same as `name` (older name). */
     full_name?: string;
     first_name?: string;
     last_name?: string;
-    company_domain: string;
+    /** Employer domain (older name; `company` takes a name or a domain). */
+    company_domain?: string;
+    /** Employer name (older name; `company` takes a name or a domain). */
+    company_name?: string;
 }
 export interface PersonEmailStatusOptions extends ToolOptions {
     email: string;
 }
-export interface PersonDossierOptions extends ToolOptions {
+export interface PersonDossierOptions extends ToolOptions, PersonIdentity {
     /** Off by default. Adds the per-person add-on on the pricing page for up to one person; no phone hit guaranteed. */
     includePhone?: boolean;
-    email?: string;
-    social_media_url?: string;
-    name?: string;
-    company?: string;
 }
-export interface PersonSocialAccountsOptions extends ToolOptions {
-    email?: string;
-    social_media_url?: string;
+export interface PersonSocialAccountsOptions extends ToolOptions, PersonIdentity {
 }
 export interface PersonArticlesOptions extends ToolOptions {
     name: string;
@@ -406,16 +430,11 @@ export interface PersonArticlesOptions extends ToolOptions {
     sort?: 'recent' | 'popular';
     limit?: number;
 }
-export interface PersonPostsOptions extends ToolOptions {
-    social_media_url: string;
+export interface PersonPostsOptions extends ToolOptions, PersonIdentity {
 }
-export interface PersonInterestsOptions extends ToolOptions {
-    email?: string;
-    phone?: string;
-    social_media_url?: string;
+export interface PersonInterestsOptions extends ToolOptions, PersonIdentity {
 }
-export interface PersonFollowersOptions extends ToolOptions {
-    social_media_url: string;
+export interface PersonFollowersOptions extends ToolOptions, PersonIdentity {
     type?: 'replies' | 'followers' | 'following' | 'followers,following';
     max_results?: number;
 }
@@ -1686,6 +1705,11 @@ export interface ComputeGoalStatus {
         next_run_at: string | null;
     };
 }
+/**
+ * Observes distinct goal statuses from getComputeGoal, including the terminal
+ * status before settlement. Throws/rejections are ignored; promises aren't awaited.
+ */
+export type ComputeStatusUpdateFn = (status: ComputeGoalStatus['status'], goalId: string) => void;
 /** One thing a goal's task produced: a file a sandbox task left, or a tool result too large for the task row. */
 export interface ComputeOutput {
     /** Path-like key, e.g. `artifacts/<task_id>/result.txt`. */