gumnut-sdk 0.125.0 → 0.127.0
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/CHANGELOG.md +16 -0
- package/package.json +1 -1
- package/resources/assets.d.mts +33 -7
- package/resources/assets.d.mts.map +1 -1
- package/resources/assets.d.ts +33 -7
- package/resources/assets.d.ts.map +1 -1
- package/resources/assets.js +14 -7
- package/resources/assets.js.map +1 -1
- package/resources/assets.mjs +14 -7
- package/resources/assets.mjs.map +1 -1
- package/resources/search.d.mts +28 -3
- package/resources/search.d.mts.map +1 -1
- package/resources/search.d.ts +28 -3
- package/resources/search.d.ts.map +1 -1
- package/resources/search.js +7 -3
- package/resources/search.js.map +1 -1
- package/resources/search.mjs +7 -3
- package/resources/search.mjs.map +1 -1
- package/src/resources/assets.ts +36 -7
- package/src/resources/search.ts +32 -3
- package/src/version.ts +1 -1
- package/version.d.mts +1 -1
- package/version.d.ts +1 -1
- package/version.js +1 -1
- package/version.mjs +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,21 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.127.0 (2026-07-02)
|
|
4
|
+
|
|
5
|
+
Full Changelog: [v0.126.0...v0.127.0](https://github.com/gumnut-ai/photos-sdk-typescript/compare/v0.126.0...v0.127.0)
|
|
6
|
+
|
|
7
|
+
### Features
|
|
8
|
+
|
|
9
|
+
* **api:** api update ([8f08297](https://github.com/gumnut-ai/photos-sdk-typescript/commit/8f08297d87f3fa171d1442035fc0ae810702a6d0))
|
|
10
|
+
|
|
11
|
+
## 0.126.0 (2026-07-02)
|
|
12
|
+
|
|
13
|
+
Full Changelog: [v0.125.0...v0.126.0](https://github.com/gumnut-ai/photos-sdk-typescript/compare/v0.125.0...v0.126.0)
|
|
14
|
+
|
|
15
|
+
### Features
|
|
16
|
+
|
|
17
|
+
* **api:** api update ([74cfe5d](https://github.com/gumnut-ai/photos-sdk-typescript/commit/74cfe5d372f31ef26adf35cd81ee683377e7da4d))
|
|
18
|
+
|
|
3
19
|
## 0.125.0 (2026-06-26)
|
|
4
20
|
|
|
5
21
|
Full Changelog: [v0.124.0...v0.125.0](https://github.com/gumnut-ai/photos-sdk-typescript/compare/v0.124.0...v0.125.0)
|
package/package.json
CHANGED
package/resources/assets.d.mts
CHANGED
|
@@ -25,15 +25,22 @@ export declare class Assets extends APIResource {
|
|
|
25
25
|
retrieve(assetID: string, query?: AssetRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<AssetResponse>;
|
|
26
26
|
/**
|
|
27
27
|
* Returns a paginated list of assets ordered by local capture time (newest first),
|
|
28
|
-
* optionally filtered by album, person, date range, or asset ID.
|
|
29
|
-
* structured browsing and filtering — when the request can be
|
|
30
|
-
* filters on album membership, people, date range,
|
|
28
|
+
* optionally filtered by album, person, date range, geographic area, or asset ID.
|
|
29
|
+
* Use this tool for structured browsing and filtering — when the request can be
|
|
30
|
+
* expressed as exact filters on album membership, people, date range, geographic
|
|
31
|
+
* coordinates, or specific asset IDs.
|
|
32
|
+
*
|
|
33
|
+
* **Location filtering is by coordinate:** pass a radius (`center` + `radius`) or
|
|
34
|
+
* a bounding box (`bbox`) to restrict results to a geographic area. The two modes
|
|
35
|
+
* are mutually exclusive. To count or cluster geotagged assets across a map
|
|
36
|
+
* viewport (how many photos fall in each area) rather than list them, use
|
|
37
|
+
* `get_geo_clusters`.
|
|
31
38
|
*
|
|
32
39
|
* **Use `search_assets` instead** when the request involves natural-language image
|
|
33
|
-
* content ('photos of sunsets', 'pictures with my dog'),
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
* caption text.
|
|
40
|
+
* content ('photos of sunsets', 'pictures with my dog'), a place _name_ ('photos
|
|
41
|
+
* from Japan'), or any concept requiring semantic understanding of what's in the
|
|
42
|
+
* image. `list_assets` filters by coordinate but not by image content, place name,
|
|
43
|
+
* or caption text.
|
|
37
44
|
*
|
|
38
45
|
* **To present a curated set of specific assets to the user** (e.g., a hand-picked
|
|
39
46
|
* subset of `search_assets` results), call this tool with `ids=[...]` rather than
|
|
@@ -591,6 +598,20 @@ export interface AssetListParams extends CursorPageParams {
|
|
|
591
598
|
* param when you need the full asset metadata in one call.
|
|
592
599
|
*/
|
|
593
600
|
album_id?: string | null;
|
|
601
|
+
/**
|
|
602
|
+
* Bounding-box (map viewport) location filter: four comma-separated decimal-degree
|
|
603
|
+
* numbers `min_longitude,min_latitude,max_longitude,max_latitude`
|
|
604
|
+
* (west,south,east,north), e.g. `-77.1,38.9,-77.0,39.0`. Mutually exclusive with
|
|
605
|
+
* `center`/`radius`. A box whose `min_longitude` exceeds `max_longitude`
|
|
606
|
+
* (antimeridian-crossing) is accepted but matches nothing — split it client-side.
|
|
607
|
+
*/
|
|
608
|
+
bbox?: string | null;
|
|
609
|
+
/**
|
|
610
|
+
* Center point of a radius location filter: two comma-separated decimal-degree
|
|
611
|
+
* numbers `longitude,latitude`, e.g. `-77.05,38.95`. Supply with `radius`.
|
|
612
|
+
* Mutually exclusive with `bbox`.
|
|
613
|
+
*/
|
|
614
|
+
center?: string | null;
|
|
594
615
|
/**
|
|
595
616
|
* Look up specific assets by ID (max 100; each ID has the `asset_` prefix).
|
|
596
617
|
* Accepts multiple `ids=` query params or a single comma-delimited value (e.g.,
|
|
@@ -641,6 +662,11 @@ export interface AssetListParams extends CursorPageParams {
|
|
|
641
662
|
* tool; the sibling `search_assets` uses `person_ids` (plural, ALL-of).
|
|
642
663
|
*/
|
|
643
664
|
person_id?: string | null;
|
|
665
|
+
/**
|
|
666
|
+
* Radius of the `center` location filter, in meters (greater than 0, at most
|
|
667
|
+
* 50000).
|
|
668
|
+
*/
|
|
669
|
+
radius?: number | null;
|
|
644
670
|
/**
|
|
645
671
|
* Which set of assets to read from: `live` (default — only assets that are not
|
|
646
672
|
* trashed), `trashed` (only trashed assets, ordered by most recently trashed), or
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"assets.d.mts","sourceRoot":"","sources":["../src/resources/assets.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,OAAO,KAAK,QAAQ,oBAAgB;AACpC,OAAO,KAAK,SAAS,qBAAiB;AACtC,OAAO,KAAK,MAAM,qBAAiB;AACnC,OAAO,EAAE,UAAU,EAAE,gCAA4B;AACjD,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,WAAW,EAAE,+BAA2B;AACpF,OAAO,EAAE,KAAK,UAAU,EAAE,4BAAwB;AAClD,OAAO,EAAE,cAAc,EAAE,wCAAoC;AAI7D,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC;IAIpF;;;;;;;OAOG;IACH,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,mBAAmB,GAAG,IAAI,GAAG,SAAc,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,aAAa,CAAC;IAI5B
|
|
1
|
+
{"version":3,"file":"assets.d.mts","sourceRoot":"","sources":["../src/resources/assets.ts"],"names":[],"mappings":"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"}
|
package/resources/assets.d.ts
CHANGED
|
@@ -25,15 +25,22 @@ export declare class Assets extends APIResource {
|
|
|
25
25
|
retrieve(assetID: string, query?: AssetRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<AssetResponse>;
|
|
26
26
|
/**
|
|
27
27
|
* Returns a paginated list of assets ordered by local capture time (newest first),
|
|
28
|
-
* optionally filtered by album, person, date range, or asset ID.
|
|
29
|
-
* structured browsing and filtering — when the request can be
|
|
30
|
-
* filters on album membership, people, date range,
|
|
28
|
+
* optionally filtered by album, person, date range, geographic area, or asset ID.
|
|
29
|
+
* Use this tool for structured browsing and filtering — when the request can be
|
|
30
|
+
* expressed as exact filters on album membership, people, date range, geographic
|
|
31
|
+
* coordinates, or specific asset IDs.
|
|
32
|
+
*
|
|
33
|
+
* **Location filtering is by coordinate:** pass a radius (`center` + `radius`) or
|
|
34
|
+
* a bounding box (`bbox`) to restrict results to a geographic area. The two modes
|
|
35
|
+
* are mutually exclusive. To count or cluster geotagged assets across a map
|
|
36
|
+
* viewport (how many photos fall in each area) rather than list them, use
|
|
37
|
+
* `get_geo_clusters`.
|
|
31
38
|
*
|
|
32
39
|
* **Use `search_assets` instead** when the request involves natural-language image
|
|
33
|
-
* content ('photos of sunsets', 'pictures with my dog'),
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
* caption text.
|
|
40
|
+
* content ('photos of sunsets', 'pictures with my dog'), a place _name_ ('photos
|
|
41
|
+
* from Japan'), or any concept requiring semantic understanding of what's in the
|
|
42
|
+
* image. `list_assets` filters by coordinate but not by image content, place name,
|
|
43
|
+
* or caption text.
|
|
37
44
|
*
|
|
38
45
|
* **To present a curated set of specific assets to the user** (e.g., a hand-picked
|
|
39
46
|
* subset of `search_assets` results), call this tool with `ids=[...]` rather than
|
|
@@ -591,6 +598,20 @@ export interface AssetListParams extends CursorPageParams {
|
|
|
591
598
|
* param when you need the full asset metadata in one call.
|
|
592
599
|
*/
|
|
593
600
|
album_id?: string | null;
|
|
601
|
+
/**
|
|
602
|
+
* Bounding-box (map viewport) location filter: four comma-separated decimal-degree
|
|
603
|
+
* numbers `min_longitude,min_latitude,max_longitude,max_latitude`
|
|
604
|
+
* (west,south,east,north), e.g. `-77.1,38.9,-77.0,39.0`. Mutually exclusive with
|
|
605
|
+
* `center`/`radius`. A box whose `min_longitude` exceeds `max_longitude`
|
|
606
|
+
* (antimeridian-crossing) is accepted but matches nothing — split it client-side.
|
|
607
|
+
*/
|
|
608
|
+
bbox?: string | null;
|
|
609
|
+
/**
|
|
610
|
+
* Center point of a radius location filter: two comma-separated decimal-degree
|
|
611
|
+
* numbers `longitude,latitude`, e.g. `-77.05,38.95`. Supply with `radius`.
|
|
612
|
+
* Mutually exclusive with `bbox`.
|
|
613
|
+
*/
|
|
614
|
+
center?: string | null;
|
|
594
615
|
/**
|
|
595
616
|
* Look up specific assets by ID (max 100; each ID has the `asset_` prefix).
|
|
596
617
|
* Accepts multiple `ids=` query params or a single comma-delimited value (e.g.,
|
|
@@ -641,6 +662,11 @@ export interface AssetListParams extends CursorPageParams {
|
|
|
641
662
|
* tool; the sibling `search_assets` uses `person_ids` (plural, ALL-of).
|
|
642
663
|
*/
|
|
643
664
|
person_id?: string | null;
|
|
665
|
+
/**
|
|
666
|
+
* Radius of the `center` location filter, in meters (greater than 0, at most
|
|
667
|
+
* 50000).
|
|
668
|
+
*/
|
|
669
|
+
radius?: number | null;
|
|
644
670
|
/**
|
|
645
671
|
* Which set of assets to read from: `live` (default — only assets that are not
|
|
646
672
|
* trashed), `trashed` (only trashed assets, ordered by most recently trashed), or
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../src/resources/assets.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,KAAK,QAAQ,mBAAgB;AACpC,OAAO,KAAK,SAAS,oBAAiB;AACtC,OAAO,KAAK,MAAM,oBAAiB;AACnC,OAAO,EAAE,UAAU,EAAE,+BAA4B;AACjD,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,WAAW,EAAE,8BAA2B;AACpF,OAAO,EAAE,KAAK,UAAU,EAAE,2BAAwB;AAClD,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAI7D,qBAAa,MAAO,SAAQ,WAAW;IACrC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC;IAIpF;;;;;;;OAOG;IACH,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,mBAAmB,GAAG,IAAI,GAAG,SAAc,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,aAAa,CAAC;IAI5B
|
|
1
|
+
{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../src/resources/assets.ts"],"names":[],"mappings":"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"}
|
package/resources/assets.js
CHANGED
|
@@ -29,15 +29,22 @@ class Assets extends resource_1.APIResource {
|
|
|
29
29
|
}
|
|
30
30
|
/**
|
|
31
31
|
* Returns a paginated list of assets ordered by local capture time (newest first),
|
|
32
|
-
* optionally filtered by album, person, date range, or asset ID.
|
|
33
|
-
* structured browsing and filtering — when the request can be
|
|
34
|
-
* filters on album membership, people, date range,
|
|
32
|
+
* optionally filtered by album, person, date range, geographic area, or asset ID.
|
|
33
|
+
* Use this tool for structured browsing and filtering — when the request can be
|
|
34
|
+
* expressed as exact filters on album membership, people, date range, geographic
|
|
35
|
+
* coordinates, or specific asset IDs.
|
|
36
|
+
*
|
|
37
|
+
* **Location filtering is by coordinate:** pass a radius (`center` + `radius`) or
|
|
38
|
+
* a bounding box (`bbox`) to restrict results to a geographic area. The two modes
|
|
39
|
+
* are mutually exclusive. To count or cluster geotagged assets across a map
|
|
40
|
+
* viewport (how many photos fall in each area) rather than list them, use
|
|
41
|
+
* `get_geo_clusters`.
|
|
35
42
|
*
|
|
36
43
|
* **Use `search_assets` instead** when the request involves natural-language image
|
|
37
|
-
* content ('photos of sunsets', 'pictures with my dog'),
|
|
38
|
-
*
|
|
39
|
-
*
|
|
40
|
-
* caption text.
|
|
44
|
+
* content ('photos of sunsets', 'pictures with my dog'), a place _name_ ('photos
|
|
45
|
+
* from Japan'), or any concept requiring semantic understanding of what's in the
|
|
46
|
+
* image. `list_assets` filters by coordinate but not by image content, place name,
|
|
47
|
+
* or caption text.
|
|
41
48
|
*
|
|
42
49
|
* **To present a curated set of specific assets to the user** (e.g., a hand-picked
|
|
43
50
|
* subset of `search_assets` results), call this tool with `ids=[...]` rather than
|
package/resources/assets.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"assets.js","sourceRoot":"","sources":["../src/resources/assets.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAK/C,sDAAoF;AAGpF,oDAAkE;AAClE,oDAA8C;AAE9C,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;OAKG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,IAAA,qCAA2B,EAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3G,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CACN,OAAe,EACf,QAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,eAAe,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED
|
|
1
|
+
{"version":3,"file":"assets.js","sourceRoot":"","sources":["../src/resources/assets.ts"],"names":[],"mappings":"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"}
|
package/resources/assets.mjs
CHANGED
|
@@ -26,15 +26,22 @@ export class Assets extends APIResource {
|
|
|
26
26
|
}
|
|
27
27
|
/**
|
|
28
28
|
* Returns a paginated list of assets ordered by local capture time (newest first),
|
|
29
|
-
* optionally filtered by album, person, date range, or asset ID.
|
|
30
|
-
* structured browsing and filtering — when the request can be
|
|
31
|
-
* filters on album membership, people, date range,
|
|
29
|
+
* optionally filtered by album, person, date range, geographic area, or asset ID.
|
|
30
|
+
* Use this tool for structured browsing and filtering — when the request can be
|
|
31
|
+
* expressed as exact filters on album membership, people, date range, geographic
|
|
32
|
+
* coordinates, or specific asset IDs.
|
|
33
|
+
*
|
|
34
|
+
* **Location filtering is by coordinate:** pass a radius (`center` + `radius`) or
|
|
35
|
+
* a bounding box (`bbox`) to restrict results to a geographic area. The two modes
|
|
36
|
+
* are mutually exclusive. To count or cluster geotagged assets across a map
|
|
37
|
+
* viewport (how many photos fall in each area) rather than list them, use
|
|
38
|
+
* `get_geo_clusters`.
|
|
32
39
|
*
|
|
33
40
|
* **Use `search_assets` instead** when the request involves natural-language image
|
|
34
|
-
* content ('photos of sunsets', 'pictures with my dog'),
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
* caption text.
|
|
41
|
+
* content ('photos of sunsets', 'pictures with my dog'), a place _name_ ('photos
|
|
42
|
+
* from Japan'), or any concept requiring semantic understanding of what's in the
|
|
43
|
+
* image. `list_assets` filters by coordinate but not by image content, place name,
|
|
44
|
+
* or caption text.
|
|
38
45
|
*
|
|
39
46
|
* **To present a curated set of specific assets to the user** (e.g., a hand-picked
|
|
40
47
|
* subset of `search_assets` results), call this tool with `ids=[...]` rather than
|
package/resources/assets.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"assets.mjs","sourceRoot":"","sources":["../src/resources/assets.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAK/C,OAAO,EAAE,UAAU,EAAsC,+BAA2B;AAGpF,OAAO,EAAE,2BAA2B,EAAE,gCAA4B;AAClE,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;OAKG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,2BAA2B,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3G,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CACN,OAAe,EACf,QAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,eAAe,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED
|
|
1
|
+
{"version":3,"file":"assets.mjs","sourceRoot":"","sources":["../src/resources/assets.ts"],"names":[],"mappings":"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"}
|
package/resources/search.d.mts
CHANGED
|
@@ -21,11 +21,15 @@ export declare class Search extends APIResource {
|
|
|
21
21
|
* filters alone (album, person, date range, ID) — it's cheaper and more
|
|
22
22
|
* deterministic than semantic search.
|
|
23
23
|
*
|
|
24
|
-
*
|
|
25
|
-
*
|
|
24
|
+
* Location filtering is by coordinate radius only: pass `center` + `radius`
|
|
25
|
+
* together to keep only assets within that circle (a filter that narrows
|
|
26
|
+
* candidates — the semantic/date ordering is unchanged). Place-name search
|
|
27
|
+
* ('photos in Paris') is not supported; pass place names as part of `query` and
|
|
28
|
+
* rely on semantic matching.
|
|
26
29
|
*
|
|
27
30
|
* At least one of `query`, `person_ids`, `captured_before`, or `captured_after`
|
|
28
|
-
* must be provided
|
|
31
|
+
* must be provided; the radius is an additional filter, not a search criterion on
|
|
32
|
+
* its own.
|
|
29
33
|
*/
|
|
30
34
|
search(query?: SearchSearchParams | null | undefined, options?: RequestOptions): APIPromise<SearchResponse>;
|
|
31
35
|
/**
|
|
@@ -67,6 +71,11 @@ export interface SearchSearchParams {
|
|
|
67
71
|
* inconsistency is tracked as a follow-up).
|
|
68
72
|
*/
|
|
69
73
|
captured_before?: string | null;
|
|
74
|
+
/**
|
|
75
|
+
* Center point of a radius location filter: two comma-separated decimal-degree
|
|
76
|
+
* numbers `longitude,latitude`, e.g. `-77.05,38.95`. Supply with `radius`.
|
|
77
|
+
*/
|
|
78
|
+
center?: string | null;
|
|
70
79
|
/**
|
|
71
80
|
* Opt-in expansion fields. Supported values: `metadata` (camera/EXIF/GPS and
|
|
72
81
|
* location names), `faces`, `people`, `metrics` (ML quality scores), `file_data`
|
|
@@ -115,6 +124,11 @@ export interface SearchSearchParams {
|
|
|
115
124
|
* 'in 2023' in `query`).
|
|
116
125
|
*/
|
|
117
126
|
query?: string | null;
|
|
127
|
+
/**
|
|
128
|
+
* Radius of the `center` location filter, in meters (greater than 0, at most
|
|
129
|
+
* 50,000).
|
|
130
|
+
*/
|
|
131
|
+
radius?: number | null;
|
|
118
132
|
/**
|
|
119
133
|
* Maximum semantic distance for a result to be included (0.0 = identical, 1.0 =
|
|
120
134
|
* unrelated). Lower values return fewer, more confident matches; higher values
|
|
@@ -151,6 +165,12 @@ export interface SearchSearchAssetsParams {
|
|
|
151
165
|
* format).
|
|
152
166
|
*/
|
|
153
167
|
captured_before?: string | null;
|
|
168
|
+
/**
|
|
169
|
+
* Body param: Center point of a radius location filter: two comma-separated
|
|
170
|
+
* decimal-degree numbers `longitude,latitude`, e.g. `-77.05,38.95`. Supply with
|
|
171
|
+
* `radius`.
|
|
172
|
+
*/
|
|
173
|
+
center?: string | null;
|
|
154
174
|
/**
|
|
155
175
|
* Body param: Image file to search for similar assets. Can be combined with text
|
|
156
176
|
* query.
|
|
@@ -182,6 +202,11 @@ export interface SearchSearchAssetsParams {
|
|
|
182
202
|
* and captured_after parameters instead.
|
|
183
203
|
*/
|
|
184
204
|
query?: string | null;
|
|
205
|
+
/**
|
|
206
|
+
* Body param: Radius of the `center` location filter, in meters (greater than 0,
|
|
207
|
+
* at most 50,000).
|
|
208
|
+
*/
|
|
209
|
+
radius?: number | null;
|
|
185
210
|
/**
|
|
186
211
|
* Body param: Similarity threshold (lower means more similar)
|
|
187
212
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search.d.mts","sourceRoot":"","sources":["../src/resources/search.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,OAAO,KAAK,SAAS,qBAAiB;AACtC,OAAO,EAAE,UAAU,EAAE,gCAA4B;AACjD,OAAO,EAAE,KAAK,UAAU,EAAE,4BAAwB;AAClD,OAAO,EAAE,cAAc,EAAE,wCAAoC;AAG7D,qBAAa,MAAO,SAAQ,WAAW;IACrC
|
|
1
|
+
{"version":3,"file":"search.d.mts","sourceRoot":"","sources":["../src/resources/search.ts"],"names":[],"mappings":"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"}
|
package/resources/search.d.ts
CHANGED
|
@@ -21,11 +21,15 @@ export declare class Search extends APIResource {
|
|
|
21
21
|
* filters alone (album, person, date range, ID) — it's cheaper and more
|
|
22
22
|
* deterministic than semantic search.
|
|
23
23
|
*
|
|
24
|
-
*
|
|
25
|
-
*
|
|
24
|
+
* Location filtering is by coordinate radius only: pass `center` + `radius`
|
|
25
|
+
* together to keep only assets within that circle (a filter that narrows
|
|
26
|
+
* candidates — the semantic/date ordering is unchanged). Place-name search
|
|
27
|
+
* ('photos in Paris') is not supported; pass place names as part of `query` and
|
|
28
|
+
* rely on semantic matching.
|
|
26
29
|
*
|
|
27
30
|
* At least one of `query`, `person_ids`, `captured_before`, or `captured_after`
|
|
28
|
-
* must be provided
|
|
31
|
+
* must be provided; the radius is an additional filter, not a search criterion on
|
|
32
|
+
* its own.
|
|
29
33
|
*/
|
|
30
34
|
search(query?: SearchSearchParams | null | undefined, options?: RequestOptions): APIPromise<SearchResponse>;
|
|
31
35
|
/**
|
|
@@ -67,6 +71,11 @@ export interface SearchSearchParams {
|
|
|
67
71
|
* inconsistency is tracked as a follow-up).
|
|
68
72
|
*/
|
|
69
73
|
captured_before?: string | null;
|
|
74
|
+
/**
|
|
75
|
+
* Center point of a radius location filter: two comma-separated decimal-degree
|
|
76
|
+
* numbers `longitude,latitude`, e.g. `-77.05,38.95`. Supply with `radius`.
|
|
77
|
+
*/
|
|
78
|
+
center?: string | null;
|
|
70
79
|
/**
|
|
71
80
|
* Opt-in expansion fields. Supported values: `metadata` (camera/EXIF/GPS and
|
|
72
81
|
* location names), `faces`, `people`, `metrics` (ML quality scores), `file_data`
|
|
@@ -115,6 +124,11 @@ export interface SearchSearchParams {
|
|
|
115
124
|
* 'in 2023' in `query`).
|
|
116
125
|
*/
|
|
117
126
|
query?: string | null;
|
|
127
|
+
/**
|
|
128
|
+
* Radius of the `center` location filter, in meters (greater than 0, at most
|
|
129
|
+
* 50,000).
|
|
130
|
+
*/
|
|
131
|
+
radius?: number | null;
|
|
118
132
|
/**
|
|
119
133
|
* Maximum semantic distance for a result to be included (0.0 = identical, 1.0 =
|
|
120
134
|
* unrelated). Lower values return fewer, more confident matches; higher values
|
|
@@ -151,6 +165,12 @@ export interface SearchSearchAssetsParams {
|
|
|
151
165
|
* format).
|
|
152
166
|
*/
|
|
153
167
|
captured_before?: string | null;
|
|
168
|
+
/**
|
|
169
|
+
* Body param: Center point of a radius location filter: two comma-separated
|
|
170
|
+
* decimal-degree numbers `longitude,latitude`, e.g. `-77.05,38.95`. Supply with
|
|
171
|
+
* `radius`.
|
|
172
|
+
*/
|
|
173
|
+
center?: string | null;
|
|
154
174
|
/**
|
|
155
175
|
* Body param: Image file to search for similar assets. Can be combined with text
|
|
156
176
|
* query.
|
|
@@ -182,6 +202,11 @@ export interface SearchSearchAssetsParams {
|
|
|
182
202
|
* and captured_after parameters instead.
|
|
183
203
|
*/
|
|
184
204
|
query?: string | null;
|
|
205
|
+
/**
|
|
206
|
+
* Body param: Radius of the `center` location filter, in meters (greater than 0,
|
|
207
|
+
* at most 50,000).
|
|
208
|
+
*/
|
|
209
|
+
radius?: number | null;
|
|
185
210
|
/**
|
|
186
211
|
* Body param: Similarity threshold (lower means more similar)
|
|
187
212
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/resources/search.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,KAAK,SAAS,oBAAiB;AACtC,OAAO,EAAE,UAAU,EAAE,+BAA4B;AACjD,OAAO,EAAE,KAAK,UAAU,EAAE,2BAAwB;AAClD,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAG7D,qBAAa,MAAO,SAAQ,WAAW;IACrC
|
|
1
|
+
{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/resources/search.ts"],"names":[],"mappings":"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"}
|
package/resources/search.js
CHANGED
|
@@ -22,11 +22,15 @@ class Search extends resource_1.APIResource {
|
|
|
22
22
|
* filters alone (album, person, date range, ID) — it's cheaper and more
|
|
23
23
|
* deterministic than semantic search.
|
|
24
24
|
*
|
|
25
|
-
*
|
|
26
|
-
*
|
|
25
|
+
* Location filtering is by coordinate radius only: pass `center` + `radius`
|
|
26
|
+
* together to keep only assets within that circle (a filter that narrows
|
|
27
|
+
* candidates — the semantic/date ordering is unchanged). Place-name search
|
|
28
|
+
* ('photos in Paris') is not supported; pass place names as part of `query` and
|
|
29
|
+
* rely on semantic matching.
|
|
27
30
|
*
|
|
28
31
|
* At least one of `query`, `person_ids`, `captured_before`, or `captured_after`
|
|
29
|
-
* must be provided
|
|
32
|
+
* must be provided; the radius is an additional filter, not a search criterion on
|
|
33
|
+
* its own.
|
|
30
34
|
*/
|
|
31
35
|
search(query = {}, options) {
|
|
32
36
|
return this._client.get('/api/search', { query, ...options });
|
package/resources/search.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/resources/search.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAK/C,oDAAkE;AAElE,MAAa,MAAO,SAAQ,sBAAW;IACrC
|
|
1
|
+
{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/resources/search.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAK/C,oDAAkE;AAElE,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CACJ,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;OAIG;IACH,YAAY,CACV,SAAsD,EAAE,EACxD,OAAwB;QAExB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,aAAa,EACb,IAAA,qCAA2B,EAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CACpF,CAAC;IACJ,CAAC;CACF;AAlDD,wBAkDC"}
|
package/resources/search.mjs
CHANGED
|
@@ -19,11 +19,15 @@ export class Search extends APIResource {
|
|
|
19
19
|
* filters alone (album, person, date range, ID) — it's cheaper and more
|
|
20
20
|
* deterministic than semantic search.
|
|
21
21
|
*
|
|
22
|
-
*
|
|
23
|
-
*
|
|
22
|
+
* Location filtering is by coordinate radius only: pass `center` + `radius`
|
|
23
|
+
* together to keep only assets within that circle (a filter that narrows
|
|
24
|
+
* candidates — the semantic/date ordering is unchanged). Place-name search
|
|
25
|
+
* ('photos in Paris') is not supported; pass place names as part of `query` and
|
|
26
|
+
* rely on semantic matching.
|
|
24
27
|
*
|
|
25
28
|
* At least one of `query`, `person_ids`, `captured_before`, or `captured_after`
|
|
26
|
-
* must be provided
|
|
29
|
+
* must be provided; the radius is an additional filter, not a search criterion on
|
|
30
|
+
* its own.
|
|
27
31
|
*/
|
|
28
32
|
search(query = {}, options) {
|
|
29
33
|
return this._client.get('/api/search', { query, ...options });
|
package/resources/search.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search.mjs","sourceRoot":"","sources":["../src/resources/search.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAK/C,OAAO,EAAE,2BAA2B,EAAE,gCAA4B;AAElE,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC
|
|
1
|
+
{"version":3,"file":"search.mjs","sourceRoot":"","sources":["../src/resources/search.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAK/C,OAAO,EAAE,2BAA2B,EAAE,gCAA4B;AAElE,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CACJ,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;OAIG;IACH,YAAY,CACV,SAAsD,EAAE,EACxD,OAAwB;QAExB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,aAAa,EACb,2BAA2B,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CACpF,CAAC;IACJ,CAAC;CACF"}
|
package/src/resources/assets.ts
CHANGED
|
@@ -40,15 +40,22 @@ export class Assets extends APIResource {
|
|
|
40
40
|
|
|
41
41
|
/**
|
|
42
42
|
* Returns a paginated list of assets ordered by local capture time (newest first),
|
|
43
|
-
* optionally filtered by album, person, date range, or asset ID.
|
|
44
|
-
* structured browsing and filtering — when the request can be
|
|
45
|
-
* filters on album membership, people, date range,
|
|
43
|
+
* optionally filtered by album, person, date range, geographic area, or asset ID.
|
|
44
|
+
* Use this tool for structured browsing and filtering — when the request can be
|
|
45
|
+
* expressed as exact filters on album membership, people, date range, geographic
|
|
46
|
+
* coordinates, or specific asset IDs.
|
|
47
|
+
*
|
|
48
|
+
* **Location filtering is by coordinate:** pass a radius (`center` + `radius`) or
|
|
49
|
+
* a bounding box (`bbox`) to restrict results to a geographic area. The two modes
|
|
50
|
+
* are mutually exclusive. To count or cluster geotagged assets across a map
|
|
51
|
+
* viewport (how many photos fall in each area) rather than list them, use
|
|
52
|
+
* `get_geo_clusters`.
|
|
46
53
|
*
|
|
47
54
|
* **Use `search_assets` instead** when the request involves natural-language image
|
|
48
|
-
* content ('photos of sunsets', 'pictures with my dog'),
|
|
49
|
-
*
|
|
50
|
-
*
|
|
51
|
-
* caption text.
|
|
55
|
+
* content ('photos of sunsets', 'pictures with my dog'), a place _name_ ('photos
|
|
56
|
+
* from Japan'), or any concept requiring semantic understanding of what's in the
|
|
57
|
+
* image. `list_assets` filters by coordinate but not by image content, place name,
|
|
58
|
+
* or caption text.
|
|
52
59
|
*
|
|
53
60
|
* **To present a curated set of specific assets to the user** (e.g., a hand-picked
|
|
54
61
|
* subset of `search_assets` results), call this tool with `ids=[...]` rather than
|
|
@@ -734,6 +741,22 @@ export interface AssetListParams extends CursorPageParams {
|
|
|
734
741
|
*/
|
|
735
742
|
album_id?: string | null;
|
|
736
743
|
|
|
744
|
+
/**
|
|
745
|
+
* Bounding-box (map viewport) location filter: four comma-separated decimal-degree
|
|
746
|
+
* numbers `min_longitude,min_latitude,max_longitude,max_latitude`
|
|
747
|
+
* (west,south,east,north), e.g. `-77.1,38.9,-77.0,39.0`. Mutually exclusive with
|
|
748
|
+
* `center`/`radius`. A box whose `min_longitude` exceeds `max_longitude`
|
|
749
|
+
* (antimeridian-crossing) is accepted but matches nothing — split it client-side.
|
|
750
|
+
*/
|
|
751
|
+
bbox?: string | null;
|
|
752
|
+
|
|
753
|
+
/**
|
|
754
|
+
* Center point of a radius location filter: two comma-separated decimal-degree
|
|
755
|
+
* numbers `longitude,latitude`, e.g. `-77.05,38.95`. Supply with `radius`.
|
|
756
|
+
* Mutually exclusive with `bbox`.
|
|
757
|
+
*/
|
|
758
|
+
center?: string | null;
|
|
759
|
+
|
|
737
760
|
/**
|
|
738
761
|
* Look up specific assets by ID (max 100; each ID has the `asset_` prefix).
|
|
739
762
|
* Accepts multiple `ids=` query params or a single comma-delimited value (e.g.,
|
|
@@ -790,6 +813,12 @@ export interface AssetListParams extends CursorPageParams {
|
|
|
790
813
|
*/
|
|
791
814
|
person_id?: string | null;
|
|
792
815
|
|
|
816
|
+
/**
|
|
817
|
+
* Radius of the `center` location filter, in meters (greater than 0, at most
|
|
818
|
+
* 50000).
|
|
819
|
+
*/
|
|
820
|
+
radius?: number | null;
|
|
821
|
+
|
|
793
822
|
/**
|
|
794
823
|
* Which set of assets to read from: `live` (default — only assets that are not
|
|
795
824
|
* trashed), `trashed` (only trashed assets, ordered by most recently trashed), or
|
package/src/resources/search.ts
CHANGED
|
@@ -25,11 +25,15 @@ export class Search extends APIResource {
|
|
|
25
25
|
* filters alone (album, person, date range, ID) — it's cheaper and more
|
|
26
26
|
* deterministic than semantic search.
|
|
27
27
|
*
|
|
28
|
-
*
|
|
29
|
-
*
|
|
28
|
+
* Location filtering is by coordinate radius only: pass `center` + `radius`
|
|
29
|
+
* together to keep only assets within that circle (a filter that narrows
|
|
30
|
+
* candidates — the semantic/date ordering is unchanged). Place-name search
|
|
31
|
+
* ('photos in Paris') is not supported; pass place names as part of `query` and
|
|
32
|
+
* rely on semantic matching.
|
|
30
33
|
*
|
|
31
34
|
* At least one of `query`, `person_ids`, `captured_before`, or `captured_after`
|
|
32
|
-
* must be provided
|
|
35
|
+
* must be provided; the radius is an additional filter, not a search criterion on
|
|
36
|
+
* its own.
|
|
33
37
|
*/
|
|
34
38
|
search(
|
|
35
39
|
query: SearchSearchParams | null | undefined = {},
|
|
@@ -92,6 +96,12 @@ export interface SearchSearchParams {
|
|
|
92
96
|
*/
|
|
93
97
|
captured_before?: string | null;
|
|
94
98
|
|
|
99
|
+
/**
|
|
100
|
+
* Center point of a radius location filter: two comma-separated decimal-degree
|
|
101
|
+
* numbers `longitude,latitude`, e.g. `-77.05,38.95`. Supply with `radius`.
|
|
102
|
+
*/
|
|
103
|
+
center?: string | null;
|
|
104
|
+
|
|
95
105
|
/**
|
|
96
106
|
* Opt-in expansion fields. Supported values: `metadata` (camera/EXIF/GPS and
|
|
97
107
|
* location names), `faces`, `people`, `metrics` (ML quality scores), `file_data`
|
|
@@ -146,6 +156,12 @@ export interface SearchSearchParams {
|
|
|
146
156
|
*/
|
|
147
157
|
query?: string | null;
|
|
148
158
|
|
|
159
|
+
/**
|
|
160
|
+
* Radius of the `center` location filter, in meters (greater than 0, at most
|
|
161
|
+
* 50,000).
|
|
162
|
+
*/
|
|
163
|
+
radius?: number | null;
|
|
164
|
+
|
|
149
165
|
/**
|
|
150
166
|
* Maximum semantic distance for a result to be included (0.0 = identical, 1.0 =
|
|
151
167
|
* unrelated). Lower values return fewer, more confident matches; higher values
|
|
@@ -186,6 +202,13 @@ export interface SearchSearchAssetsParams {
|
|
|
186
202
|
*/
|
|
187
203
|
captured_before?: string | null;
|
|
188
204
|
|
|
205
|
+
/**
|
|
206
|
+
* Body param: Center point of a radius location filter: two comma-separated
|
|
207
|
+
* decimal-degree numbers `longitude,latitude`, e.g. `-77.05,38.95`. Supply with
|
|
208
|
+
* `radius`.
|
|
209
|
+
*/
|
|
210
|
+
center?: string | null;
|
|
211
|
+
|
|
189
212
|
/**
|
|
190
213
|
* Body param: Image file to search for similar assets. Can be combined with text
|
|
191
214
|
* query.
|
|
@@ -223,6 +246,12 @@ export interface SearchSearchAssetsParams {
|
|
|
223
246
|
*/
|
|
224
247
|
query?: string | null;
|
|
225
248
|
|
|
249
|
+
/**
|
|
250
|
+
* Body param: Radius of the `center` location filter, in meters (greater than 0,
|
|
251
|
+
* at most 50,000).
|
|
252
|
+
*/
|
|
253
|
+
radius?: number | null;
|
|
254
|
+
|
|
226
255
|
/**
|
|
227
256
|
* Body param: Similarity threshold (lower means more similar)
|
|
228
257
|
*/
|
package/src/version.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export const VERSION = '0.
|
|
1
|
+
export const VERSION = '0.127.0'; // x-release-please-version
|
package/version.d.mts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export declare const VERSION = "0.
|
|
1
|
+
export declare const VERSION = "0.127.0";
|
|
2
2
|
//# sourceMappingURL=version.d.mts.map
|
package/version.d.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export declare const VERSION = "0.
|
|
1
|
+
export declare const VERSION = "0.127.0";
|
|
2
2
|
//# sourceMappingURL=version.d.ts.map
|
package/version.js
CHANGED
package/version.mjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export const VERSION = '0.
|
|
1
|
+
export const VERSION = '0.127.0'; // x-release-please-version
|
|
2
2
|
//# sourceMappingURL=version.mjs.map
|