@oneshot-agent/sdk 0.16.1 → 0.17.0

package/README.md

@@ -305,6 +305,23 @@ await agent.email({
 });
 ```
 
+### Custom Sender (name, mailbox, domain)
+
+```typescript
+// Renders as: From: Jane Doe <jane@acme.com>
+await agent.email({
+  to: 'user@example.com',
+  subject: 'Hello',
+  body: 'Sent from a custom sender.',
+  from_name: 'Jane Doe',    // display name (optional)
+  from_mailbox: 'jane',     // local-part, defaults to "agent"
+  from_domain: 'acme.com'   // defaults to "oneshotagent.com"
+});
+```
+
+`from_domain` must be a domain you've provisioned through OneShot. Defaults
+produce `agent@oneshotagent.com`.
+
 ### People Search & Enrichment
 
 ```typescript

package/dist/errors.d.ts

@@ -0,0 +1,31 @@
+export declare class OneShotError extends Error {
+    constructor(message: string);
+}
+export declare class ToolError extends OneShotError {
+    readonly statusCode: number;
+    readonly responseBody: string;
+    constructor(message: string, statusCode: number, responseBody: string);
+}
+export declare class JobError extends OneShotError {
+    readonly jobId: string;
+    readonly jobError: string;
+    constructor(message: string, jobId: string, jobError: string);
+}
+export declare class JobTimeoutError extends OneShotError {
+    readonly jobId: string;
+    readonly elapsedMs: number;
+    constructor(jobId: string, elapsedMs: number);
+}
+export declare class ValidationError extends OneShotError {
+    readonly field: string;
+    constructor(message: string, field: string);
+}
+export declare class ContentBlockedError extends OneShotError {
+    readonly categories: string[];
+    constructor(message: string, categories: string[]);
+}
+export declare class EmergencyNumberError extends OneShotError {
+    readonly blockedNumber: string;
+    constructor(message: string, blockedNumber: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAMA,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,SAAU,SAAQ,YAAY;aAGvB,UAAU,EAAE,MAAM;aAClB,YAAY,EAAE,MAAM;gBAFpC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM;CAKvC;AAED,qBAAa,QAAS,SAAQ,YAAY;aAGtB,KAAK,EAAE,MAAM;aACb,QAAQ,EAAE,MAAM;gBAFhC,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM;CAKnC;AAED,qBAAa,eAAgB,SAAQ,YAAY;aAE7B,KAAK,EAAE,MAAM;aACb,SAAS,EAAE,MAAM;gBADjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM;CAKpC;AAED,qBAAa,eAAgB,SAAQ,YAAY;aACF,KAAK,EAAE,MAAM;gBAA9C,OAAO,EAAE,MAAM,EAAkB,KAAK,EAAE,MAAM;CAI3D;AAED,qBAAa,mBAAoB,SAAQ,YAAY;aAGjC,UAAU,EAAE,MAAM,EAAE;gBADpC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAAE;CAKvC;AAED,qBAAa,oBAAqB,SAAQ,YAAY;aAGlC,aAAa,EAAE,MAAM;gBADrC,OAAO,EAAE,MAAM,EACC,aAAa,EAAE,MAAM;CAKxC"}

package/dist/errors.js

@@ -0,0 +1,68 @@
+"use strict";
+// Custom error hierarchy. Every SDK-thrown error is a subclass of OneShotError
+// so consumers can `catch (err instanceof OneShotError)` once and inspect
+// `err.name` for the specific type. Each subclass carries the structured fields
+// that drove the throw (statusCode/responseBody, jobId, field, categories, …)
+// so error handlers don't need to re-parse strings.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmergencyNumberError = exports.ContentBlockedError = exports.ValidationError = exports.JobTimeoutError = exports.JobError = exports.ToolError = exports.OneShotError = void 0;
+class OneShotError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'OneShotError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.OneShotError = OneShotError;
+class ToolError extends OneShotError {
+    constructor(message, statusCode, responseBody) {
+        super(message);
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+        this.name = 'ToolError';
+    }
+}
+exports.ToolError = ToolError;
+class JobError extends OneShotError {
+    constructor(message, jobId, jobError) {
+        super(message);
+        this.jobId = jobId;
+        this.jobError = jobError;
+        this.name = 'JobError';
+    }
+}
+exports.JobError = JobError;
+class JobTimeoutError extends OneShotError {
+    constructor(jobId, elapsedMs) {
+        super(`Job ${jobId} timed out after ${elapsedMs / 1000}s`);
+        this.jobId = jobId;
+        this.elapsedMs = elapsedMs;
+        this.name = 'JobTimeoutError';
+    }
+}
+exports.JobTimeoutError = JobTimeoutError;
+class ValidationError extends OneShotError {
+    constructor(message, field) {
+        super(message);
+        this.field = field;
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+class ContentBlockedError extends OneShotError {
+    constructor(message, categories) {
+        super(message);
+        this.categories = categories;
+        this.name = 'ContentBlockedError';
+    }
+}
+exports.ContentBlockedError = ContentBlockedError;
+class EmergencyNumberError extends OneShotError {
+    constructor(message, blockedNumber) {
+        super(message);
+        this.blockedNumber = blockedNumber;
+        this.name = 'EmergencyNumberError';
+    }
+}
+exports.EmergencyNumberError = EmergencyNumberError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,0EAA0E;AAC1E,gFAAgF;AAChF,8EAA8E;AAC9E,oDAAoD;;;AAEpD,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAND,oCAMC;AAED,MAAa,SAAU,SAAQ,YAAY;IACzC,YACE,OAAe,EACC,UAAkB,EAClB,YAAoB;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,eAAU,GAAV,UAAU,CAAQ;QAClB,iBAAY,GAAZ,YAAY,CAAQ;QAGpC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AATD,8BASC;AAED,MAAa,QAAS,SAAQ,YAAY;IACxC,YACE,OAAe,EACC,KAAa,EACb,QAAgB;QAEhC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,UAAK,GAAL,KAAK,CAAQ;QACb,aAAQ,GAAR,QAAQ,CAAQ;QAGhC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AATD,4BASC;AAED,MAAa,eAAgB,SAAQ,YAAY;IAC/C,YACkB,KAAa,EACb,SAAiB;QAEjC,KAAK,CAAC,OAAO,KAAK,oBAAoB,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC;QAH3C,UAAK,GAAL,KAAK,CAAQ;QACb,cAAS,GAAT,SAAS,CAAQ;QAGjC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AARD,0CAQC;AAED,MAAa,eAAgB,SAAQ,YAAY;IAC/C,YAAY,OAAe,EAAkB,KAAa;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAQ;QAExD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED,MAAa,mBAAoB,SAAQ,YAAY;IACnD,YACE,OAAe,EACC,UAAoB;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,eAAU,GAAV,UAAU,CAAU;QAGpC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AARD,kDAQC;AAED,MAAa,oBAAqB,SAAQ,YAAY;IACpD,YACE,OAAe,EACC,aAAqB;QAErC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,kBAAa,GAAb,aAAa,CAAQ;QAGrC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AARD,oDAQC"}