@3ngram/sdk 1.1.3 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/client.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import type { CommitmentStatus, FactsQueryArgs, FactsToolOutput, RememberToolArgs, RememberToolOutput, ResolveToolOutput, ReviseToolArgs, ReviseToolOutput, SearchQueryArgs, SearchToolOutput } from '@3ngram/schema';
1
+ import type { CommitmentStatus, FactsQueryArgs, FactsToolOutput, RememberToolArgs, RememberToolOutput, ResolveToolOutput, ReviseToolArgs, ReviseToolOutput, SearchQueryArgs, SearchRestResponseV2 } from '@3ngram/schema';
2
2
  /** Explicit client configuration. No env/flag fallback — the caller supplies both. */
3
3
  export interface ThreengramClientConfig {
4
4
  /** REST origin, e.g. `https://api.example.com` (no trailing `/api/v1`). */
@@ -30,7 +30,7 @@ export declare class ThreengramClient {
30
30
  /** POST /api/v1/memories — write a memory (commitmentId present only for commitments). */
31
31
  remember(input: RememberToolArgs): Promise<RememberToolOutput>;
32
32
  /** POST /api/v1/search — semantic search over the wider query+filters body. */
33
- search(query: string, opts?: SearchOptions): Promise<SearchToolOutput>;
33
+ search(query: string, opts?: SearchOptions): Promise<SearchRestResponseV2>;
34
34
  /** GET /api/v1/facts — currently-valid facts; filters ride as the querystring. */
35
35
  getFacts(filters?: FactsQueryArgs): Promise<FactsToolOutput>;
36
36
  /**
package/dist/client.js CHANGED
@@ -1,3 +1,4 @@
1
+ import { restErrorResponseSchema } from '@3ngram/schema';
1
2
  import { ThreengramApiError, ThreengramNetworkError } from './errors.js';
2
3
  /** Strip trailing path separators in linear time for arbitrary caller input. */
3
4
  function stripTrailingSlashes(value) {
@@ -59,8 +60,10 @@ export class ThreengramClient {
59
60
  ...(body === undefined ? {} : { body: JSON.stringify(body) }),
60
61
  };
61
62
  const response = await this.#dispatch(`${this.#baseUrl}${path}`, init);
62
- if (!response.ok)
63
- throw new ThreengramApiError(response.status, await reasonOf(response));
63
+ if (!response.ok) {
64
+ const failure = await errorOf(response);
65
+ throw new ThreengramApiError(response.status, failure.error, failure.detail);
66
+ }
64
67
  return (await response.json());
65
68
  }
66
69
  /** Run the injected fetch; a transport rejection becomes a ThreengramNetworkError. */
@@ -73,14 +76,14 @@ export class ThreengramClient {
73
76
  }
74
77
  }
75
78
  }
76
- /** Read the `{ error: <reason> }` code from a non-2xx body; 'unknown' if unparseable. */
77
- async function reasonOf(response) {
79
+ /** Parse the stable error body; fall back safely when a nonconforming peer responds. */
80
+ async function errorOf(response) {
78
81
  try {
79
- const body = (await response.json());
80
- return typeof body.error === 'string' ? body.error : 'unknown';
82
+ const parsed = restErrorResponseSchema.safeParse(await response.json());
83
+ return parsed.success ? parsed.data : { error: 'unknown' };
81
84
  }
82
85
  catch {
83
- return 'unknown';
86
+ return { error: 'unknown' };
84
87
  }
85
88
  }
86
89
  /** Build the `/api/v1/facts` querystring — subject/predicate/limit + FLAT asOf coords. */
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
package/dist/errors.d.ts CHANGED
@@ -4,7 +4,9 @@ export declare class ThreengramApiError extends Error {
4
4
  readonly status: number;
5
5
  /** The REST `{ error: <reason> }` body code (e.g. 'not_found'); 'unknown' when absent. */
6
6
  readonly reason: string;
7
- constructor(status: number, reason: string);
7
+ /** Optional bounded recovery guidance supplied by the REST error contract. */
8
+ readonly detail: string | undefined;
9
+ constructor(status: number, reason: string, detail?: string);
8
10
  }
9
11
  /** A transport-level failure: `fetch` rejected before any HTTP response arrived. */
10
12
  export declare class ThreengramNetworkError extends Error {
package/dist/errors.js CHANGED
@@ -14,11 +14,14 @@ export class ThreengramApiError extends Error {
14
14
  status;
15
15
  /** The REST `{ error: <reason> }` body code (e.g. 'not_found'); 'unknown' when absent. */
16
16
  reason;
17
- constructor(status, reason) {
17
+ /** Optional bounded recovery guidance supplied by the REST error contract. */
18
+ detail;
19
+ constructor(status, reason, detail) {
18
20
  super(`3ngram REST request failed: ${status} ${reason}`);
19
21
  this.name = 'ThreengramApiError';
20
22
  this.status = status;
21
23
  this.reason = reason;
24
+ this.detail = detail;
22
25
  }
23
26
  }
24
27
  /** A transport-level failure: `fetch` rejected before any HTTP response arrived. */
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,gFAAgF;AAChF,gFAAgF;AAChF,4EAA4E;AAC5E,4EAA4E;AAC5E,kFAAkF;AAClF,+EAA+E;AAC/E,uEAAuE;AACvE,gFAAgF;AAChF,mFAAmF;AAEnF,wFAAwF;AACxF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,yEAAyE;IAChE,MAAM,CAAQ;IACvB,0FAA0F;IACjF,MAAM,CAAQ;IAEvB,YAAY,MAAc,EAAE,MAAc;QACxC,KAAK,CAAC,+BAA+B,MAAM,IAAI,MAAM,EAAE,CAAC,CAAA;QACxD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAED,oFAAoF;AACpF,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,6EAA6E;IAC3D,KAAK,CAAS;IAEhC,YAAY,OAAe,EAAE,KAAc;QACzC,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;QACpC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;CACF"}
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,gFAAgF;AAChF,gFAAgF;AAChF,4EAA4E;AAC5E,4EAA4E;AAC5E,kFAAkF;AAClF,+EAA+E;AAC/E,uEAAuE;AACvE,gFAAgF;AAChF,mFAAmF;AAEnF,wFAAwF;AACxF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,yEAAyE;IAChE,MAAM,CAAQ;IACvB,0FAA0F;IACjF,MAAM,CAAQ;IACvB,8EAA8E;IACrE,MAAM,CAAoB;IAEnC,YAAY,MAAc,EAAE,MAAc,EAAE,MAAe;QACzD,KAAK,CAAC,+BAA+B,MAAM,IAAI,MAAM,EAAE,CAAC,CAAA;QACxD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAED,oFAAoF;AACpF,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,6EAA6E;IAC3D,KAAK,CAAS;IAEhC,YAAY,OAAe,EAAE,KAAc;QACzC,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;QACpC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;CACF"}
@@ -11,7 +11,7 @@ export declare const SDK_METHOD_NAMES: readonly ["remember", "search", "getFacts
11
11
  export declare const SDK_METHODS: readonly SdkMethodReference[];
12
12
  export declare const SDK_ERRORS: readonly [{
13
13
  readonly name: "ThreengramApiError";
14
- readonly description: "Thrown for non-2xx REST responses. Carries status and reason from the response body.";
14
+ readonly description: "Thrown for non-2xx REST responses. Carries status, reason, and optional recovery detail from the response body.";
15
15
  }, {
16
16
  readonly name: "ThreengramNetworkError";
17
17
  readonly description: "Thrown when fetch rejects before a server response is available.";
package/dist/reference.js CHANGED
@@ -23,7 +23,7 @@ export const SDK_METHODS = [
23
23
  },
24
24
  {
25
25
  name: 'search',
26
- signature: 'search(query: string, opts?: SearchOptions): Promise<SearchToolOutput>',
26
+ signature: 'search(query: string, opts?: SearchOptions): Promise<SearchRestResponseV2>',
27
27
  route: 'POST /api/v1/search',
28
28
  summary: 'Run semantic and keyword retrieval with optional pre-fusion filters.',
29
29
  requestSchema: 'search',
@@ -80,7 +80,7 @@ export const SDK_METHODS = [
80
80
  export const SDK_ERRORS = [
81
81
  {
82
82
  name: 'ThreengramApiError',
83
- description: 'Thrown for non-2xx REST responses. Carries status and reason from the response body.',
83
+ description: 'Thrown for non-2xx REST responses. Carries status, reason, and optional recovery detail from the response body.',
84
84
  },
85
85
  {
86
86
  name: 'ThreengramNetworkError',
@@ -1 +1 @@
1
- {"version":3,"file":"reference.js","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,gFAAgF;AAChF,iFAAiF;AACjF,iEAAiE;AAYjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAA;AAEhG,MAAM,CAAC,MAAM,WAAW,GAAkC;IACxD;QACE,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,gEAAgE;QAC3E,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,mEAAmE;QAC5E,aAAa,EAAE,UAAU;QACzB,cAAc,EAAE,UAAU;QAC1B,OAAO,EAAE;YACP,yBAAyB;YACzB,2BAA2B;YAC3B,4BAA4B;YAC5B,qDAAqD;YACrD,kBAAkB;YAClB,sBAAsB;YACtB,IAAI;SACL,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;IACD;QACE,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,wEAAwE;QACnF,KAAK,EAAE,qBAAqB;QAC5B,OAAO,EAAE,sEAAsE;QAC/E,aAAa,EAAE,QAAQ;QACvB,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE;YACP,8CAA8C;YAC9C,aAAa;YACb,kBAAkB;YAClB,sBAAsB;YACtB,IAAI;SACL,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;IACD;QACE,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,8DAA8D;QACzE,KAAK,EAAE,mBAAmB;QAC1B,OAAO,EAAE,gEAAgE;QACzE,aAAa,EAAE,OAAO;QACtB,cAAc,EAAE,OAAO;QACvB,OAAO,EAAE;YACP,yBAAyB;YACzB,sBAAsB;YACtB,wBAAwB;YACxB,cAAc;YACd,IAAI;SACL,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;IACD;QACE,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,6EAA6E;QACxF,KAAK,EAAE,kCAAkC;QACzC,OAAO,EAAE,qEAAqE;QAC9E,aAAa,EAAE,QAAQ;QACvB,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE;YACP,iCAAiC;YACjC,2BAA2B;YAC3B,4BAA4B;YAC5B,qEAAqE;YACrE,0BAA0B;YAC1B,IAAI;SACL,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;IACD;QACE,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,iFAAiF;QAC5F,KAAK,EAAE,mCAAmC;QAC1C,OAAO,EAAE,0EAA0E;QACnF,aAAa,EAAE,SAAS;QACxB,cAAc,EAAE,SAAS;QACzB,OAAO,EAAE,4CAA4C;KACtD;CACF,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,sFAAsF;KACzF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,kEAAkE;KAChF;CACO,CAAA"}
1
+ {"version":3,"file":"reference.js","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,gFAAgF;AAChF,iFAAiF;AACjF,iEAAiE;AAYjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAA;AAEhG,MAAM,CAAC,MAAM,WAAW,GAAkC;IACxD;QACE,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,gEAAgE;QAC3E,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,mEAAmE;QAC5E,aAAa,EAAE,UAAU;QACzB,cAAc,EAAE,UAAU;QAC1B,OAAO,EAAE;YACP,yBAAyB;YACzB,2BAA2B;YAC3B,4BAA4B;YAC5B,qDAAqD;YACrD,kBAAkB;YAClB,sBAAsB;YACtB,IAAI;SACL,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;IACD;QACE,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,4EAA4E;QACvF,KAAK,EAAE,qBAAqB;QAC5B,OAAO,EAAE,sEAAsE;QAC/E,aAAa,EAAE,QAAQ;QACvB,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE;YACP,8CAA8C;YAC9C,aAAa;YACb,kBAAkB;YAClB,sBAAsB;YACtB,IAAI;SACL,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;IACD;QACE,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,8DAA8D;QACzE,KAAK,EAAE,mBAAmB;QAC1B,OAAO,EAAE,gEAAgE;QACzE,aAAa,EAAE,OAAO;QACtB,cAAc,EAAE,OAAO;QACvB,OAAO,EAAE;YACP,yBAAyB;YACzB,sBAAsB;YACtB,wBAAwB;YACxB,cAAc;YACd,IAAI;SACL,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;IACD;QACE,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,6EAA6E;QACxF,KAAK,EAAE,kCAAkC;QACzC,OAAO,EAAE,qEAAqE;QAC9E,aAAa,EAAE,QAAQ;QACvB,cAAc,EAAE,QAAQ;QACxB,OAAO,EAAE;YACP,iCAAiC;YACjC,2BAA2B;YAC3B,4BAA4B;YAC5B,qEAAqE;YACrE,0BAA0B;YAC1B,IAAI;SACL,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;IACD;QACE,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,iFAAiF;QAC5F,KAAK,EAAE,mCAAmC;QAC1C,OAAO,EAAE,0EAA0E;QACnF,aAAa,EAAE,SAAS;QACxB,cAAc,EAAE,SAAS;QACzB,OAAO,EAAE,4CAA4C;KACtD;CACF,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,iHAAiH;KACpH;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,kEAAkE;KAChF;CACO,CAAA"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@3ngram/sdk",
3
- "version": "1.1.3",
3
+ "version": "1.2.1",
4
4
  "description": "Typed TypeScript client for the 3ngram REST API.",
5
5
  "license": "Apache-2.0",
6
6
  "homepage": "https://3ngram.ai",
@@ -43,7 +43,7 @@
43
43
  ],
44
44
  "dependencies": {
45
45
  "zod": "4.4.3",
46
- "@3ngram/schema": "0.5.0"
46
+ "@3ngram/schema": "0.6.0"
47
47
  },
48
48
  "devDependencies": {
49
49
  "@types/node": "25.9.1",