@specstream/sdk 1.1.1 → 1.3.0

package/README.md

@@ -1,6 +1,8 @@
 # @specstream/sdk
 
-TypeScript client for [SpecStream](https://specstream.ai), the live web data engine for teams and agents. Describe the list you need in plain words; SpecStream reads the web where those things live, hands back only the matches, each with the page it came from, and you pay only for the matches.
+TypeScript client for [SpecStream](https://specstream.ai), the live web data engine for teams and agents. Describe the list you need in plain words; SpecStream reads the web where those things live, hands back only the matches, and you pay for each result delivered.
+
+Source URL and read time on every value.
 
 The client has no runtime dependencies and needs Node 22 or newer. It uses the same account, permissions, projects and balance as the workspace.
 
@@ -10,6 +12,29 @@ npm install @specstream/sdk
 
 Create an API key under **Agents & API** in your SpecStream workspace and keep it in the environment: `SPECSTREAM_API_KEY`.
 
+## Search API and Extract API
+
+SpecStream has three products: Search API, Extract API and Deep Search. The first two take one call at a flat price, with no quote or approval. The sections after this one cover Deep Search.
+
+`client.webSearch` calls the [Search API](https://specstream.ai/docs/search-api), `GET /v1/web-search`, at $5 per 1,000 searches. It is the most accurate web search API in the world ([benchmarks](https://specstream.ai/benchmarks)) and answers from the live web in a few seconds. Write `q` in everyday words, in any language.
+
+`client.extractPages` calls the [Extract API](https://specstream.ai/docs/extract-api), `POST /v1/extract`, at $0.80 per 1,000 pages. It takes up to 20 URLs a call, reads web pages, PDF, Word and Excel, and returns each one's main text as `markdown` (the default) or `text`. A page with no text is free.
+
+```ts
+import { Client } from "@specstream/sdk";
+
+const client = new Client({ apiKey: process.env.SPECSTREAM_API_KEY! });
+
+const search = await client.webSearch({ q: "What is the latest stable release of PostgreSQL?" });
+console.log(search.answer?.value, search.answer?.page);
+
+const extract = await client.extractPages({
+  urls: search.sources.slice(0, 5).map((source) => source.url),
+  format: "markdown",
+});
+for (const page of extract.results) console.log(page.url, page.status, page.text);
+```
+
 ## Read a request, get the price
 
 ```ts
@@ -59,12 +84,12 @@ If the response is lost, `getCapacityRequest(savedRequestKey)` returns the same
 
 ## Pricing
 
-New accounts start with $10 of work for 30 days, no card. A delivered result costs 10 cents, 30 cents or $1 depending on how many facts it carries. No result, no charge. See [pricing](https://specstream.ai/pricing).
+New accounts start with $10 of credit for 30 days, no card. The Search API costs $5 per 1,000 searches and the Extract API $0.80 per 1,000 pages. In Deep Search, a delivered result costs 5 cents, 15 cents or $1 depending on how many facts it carries. No result, no charge. See [pricing](https://specstream.ai/pricing).
 
 ## Links
 
 - [SDK docs](https://specstream.ai/docs/sdk) and [API docs](https://specstream.ai/docs/api)
-- [Source and issues](https://github.com/Specstreamai/specstream-tools)
+- [Source and issues](https://github.com/specstream/specstream-tools)
 - [Python client](https://pypi.org/project/specstream-client/)
 - Support: support@specstream.ai
 

package/dist/index.d.ts

@@ -2,7 +2,10 @@
 import type { Schemas } from "./work-types.js";
 export type { Schemas } from "./work-types.js";
 export declare const FAMILIES: readonly ["local_business", "creator", "organization", "storefront_product", "app_listing", "job_posting", "scholarly_work", "tender", "grant", "software_repository", "software_package", "dataset", "clinical_trial", "regulatory_document", "vulnerability", "book", "podcast", "web_page", "knowledge_entity", "person"];
-export type EntityType = (typeof FAMILIES)[number];
+/** A record kind the service names today. FAMILIES lists them; they are examples, not a limit. */
+export type KnownEntityType = (typeof FAMILIES)[number];
+/** A record kind is an open string: any kind name a reading gives is valid. */
+export type EntityType = KnownEntityType | (string & {});
 export declare const DEFAULT_BASE_URL = "https://api.specstream.ai";
 export declare class SpecstreamError extends Error {
     readonly status: number | null;
@@ -28,7 +31,7 @@ export declare class Client {
     private readonly exportOrigin?;
     private readonly timeoutMs;
     constructor(options: ClientOptions);
-    families(): readonly EntityType[];
+    families(): readonly KnownEntityType[];
     compile(q: string, locale?: string): Promise<JsonMap>;
     editSpec(ast: JsonMap, operations?: JsonMap[]): Promise<JsonMap>;
     specOptions(target: string): Promise<JsonMap>;
@@ -52,6 +55,17 @@ export declare class Client {
         "limit"?: number;
         "cursor"?: string;
     }): Promise<Schemas["WorkspaceSearchPage"]>;
+    webSearch(query: {
+        "q": string;
+        "passages"?: boolean;
+    }): Promise<Schemas["WebSearchPage"]>;
+    extractPages(request: Schemas["ExtractRequest"]): Promise<Schemas["ExtractPage"]>;
+    webSearchAnswers(query?: {
+        "q"?: string;
+        "limit"?: number;
+        "cursor"?: string;
+    }): Promise<Schemas["WebSearchAnswerPage"]>;
+    webSearchAnswer(answerId: string): Promise<Schemas["WebSearchAnswer"]>;
     workspaceListNotifications(query?: {
         "tab"?: "all" | "unread" | "archived";
         "limit"?: number;
@@ -139,11 +153,30 @@ export declare class Client {
     quoteCapacityWork(request: Schemas["CapacityQuoteRequest"]): Promise<Schemas["CapacityQuoteData"]>;
     getCapacityQuote(quoteId: string): Promise<Schemas["CapacityQuoteData"]>;
     authorizeCapacityWork(request: Schemas["CapacityAuthorizeRequest"]): Promise<Schemas["CapacityExecutionData"]>;
+    startCapacityRequest(request: Schemas["CapacityStartRequest"]): Promise<Schemas["CapacityStartData"]>;
     getCapacityRequest(requestKey: string, query?: {
         "project_id"?: string;
     }): Promise<{
         [key: string]: unknown;
     }>;
+    getCapacityRequestRows(requestKey: string, query?: {
+        "project_id"?: string;
+        "cursor"?: string;
+        "limit"?: number;
+        "format"?: "json" | "markdown" | "csv";
+    }): Promise<({
+        [key: string]: unknown;
+    } | {
+        "format": "markdown" | "csv";
+        "columns": Array<{
+            "column_id": string;
+            "label": string;
+        }>;
+        "table": string;
+        "find_id"?: (string | null);
+        "accepted_count"?: number;
+        "next_cursor"?: (string | null);
+    })>;
     getCapacityExecution(findId: string): Promise<Schemas["CommerceData"]>;
     createCapacityFunding(request: Schemas["CapacityFundingRequest"]): Promise<Schemas["CapacityFundingData"]>;
     getCapacityFunding(fundingId: string): Promise<Schemas["CapacityFundingData"]>;
@@ -269,6 +302,7 @@ export declare class Client {
         "field_id"?: string;
     }): Promise<Schemas["RelationshipData"]>;
     workspaceSaveRelationships(collectionId: string, request: Schemas["RelationshipSelection"]): Promise<Schemas["RelationshipData"]>;
+    workspaceShareCollection(collectionId: string, request: Schemas["CollectionShareInput"]): Promise<Schemas["CollectionShareData"]>;
     workspaceReportResult(collectionId: string, request: Schemas["ResultReportInput"]): Promise<Schemas["ResultReportData"]>;
     listRequestTemplates(query?: {
         "record_type"?: string;

package/dist/index.js

@@ -51,8 +51,8 @@ export class SpecstreamError extends Error {
     }
 }
 export function assertFamily(entityType) {
-    if (!FAMILIES.includes(entityType)) {
-        throw new Error(`unsupported entity_type ${entityType}`);
+    if (typeof entityType !== "string" || !entityType.trim()) {
+        throw new Error("entity_type must be a non-empty string");
     }
     return entityType;
 }
@@ -220,6 +220,34 @@ export class Client {
             path += "?" + queryString.toString();
         return this.request("GET", path);
     }
+    webSearch(query) {
+        let path = `/v1/web-search`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    extractPages(request) {
+        let path = `/v1/extract`;
+        return this.request("POST", path, request);
+    }
+    webSearchAnswers(query = {}) {
+        let path = `/v1/web-search/answers`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    webSearchAnswer(answerId) {
+        let path = `/v1/web-search/answers/${encodeURIComponent(answerId)}`;
+        return this.request("GET", path);
+    }
     workspaceListNotifications(query = {}) {
         let path = `/v1/workspace/notifications`;
         const queryString = new URLSearchParams();
@@ -459,6 +487,10 @@ export class Client {
         requireWorkAuthorization(request);
         return this.request("POST", path, request);
     }
+    startCapacityRequest(request) {
+        let path = `/v1/capacity/requests`;
+        return this.request("POST", path, request);
+    }
     getCapacityRequest(requestKey, query = {}) {
         let path = `/v1/capacity/requests/${encodeURIComponent(requestKey)}`;
         const queryString = new URLSearchParams();
@@ -469,6 +501,16 @@ export class Client {
             path += "?" + queryString.toString();
         return this.request("GET", path);
     }
+    getCapacityRequestRows(requestKey, query = {}) {
+        let path = `/v1/capacity/requests/${encodeURIComponent(requestKey)}/rows`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
     getCapacityExecution(findId) {
         let path = `/v1/capacity/executions/${encodeURIComponent(findId)}`;
         return this.request("GET", path);
@@ -791,6 +833,10 @@ export class Client {
         let path = `/v1/workspace/collections/${encodeURIComponent(collectionId)}/relationships`;
         return this.request("PUT", path, request);
     }
+    workspaceShareCollection(collectionId, request) {
+        let path = `/v1/workspace/collections/${encodeURIComponent(collectionId)}/share`;
+        return this.request("POST", path, request);
+    }
     workspaceReportResult(collectionId, request) {
         let path = `/v1/workspace/collections/${encodeURIComponent(collectionId)}/reports`;
         return this.request("POST", path, request);
@@ -966,7 +1012,7 @@ export class Client {
             Authorization: token,
             Accept: "application/json",
             "Content-Type": "application/json",
-            "User-Agent": "specstream-typescript/1.1.1",
+            "User-Agent": "specstream-typescript/1.3.0",
         };
     }
     async request(method, path, body) {

package/dist/work-types.d.ts

@@ -6,6 +6,7 @@ export interface Schemas {
         "worded_evidence"?: ({
             [key: string]: unknown;
         } | null);
+        "unconfirmed"?: (Array<string> | null);
         "lineage"?: (Schemas["MatchLineage"] | null);
         "spec_version"?: "accepted_row.v1";
         "entity_id": string;
@@ -174,8 +175,6 @@ export interface Schemas {
         "members_used": number;
         "current_lists_limit": (number | null);
         "current_lists_used": number;
-        "finds_at_once": number;
-        "finds_per_hour": number;
         "capabilities": Schemas["CapacityPlanCapabilities"];
         "unlock": {
             [key: string]: "starter" | "pro" | "team" | "enterprise";
@@ -245,7 +244,8 @@ export interface Schemas {
     "CapacityMembershipData": {
         "plan_id": string;
         "pending_plan_id"?: (string | null);
-        "billed_by"?: "card" | "app_store" | "google_play";
+        "billed_by"?: "card" | "app_store" | "google_play" | "vercel" | "digitalocean";
+        "manage_url"?: (string | null);
         "next_plan"?: (string | null);
         "upgrade_pending"?: boolean;
         "payment_action_url"?: (string | null);
@@ -264,6 +264,16 @@ export interface Schemas {
     "CapacityMembershipStatusData": {
         "membership"?: (Schemas["CapacityMembershipData"] | null);
     };
+    "CapacityPartnerData": {
+        "share_percent": number;
+        "months": number;
+        "clearing_days": number;
+        "yearly_clearing_days": number;
+        "pending_cents": number;
+        "payable_cents": number;
+        "paid_cents": number;
+        "paying_accounts": number;
+    };
     "CapacityPlanCapabilities": {
         "schedules": boolean;
         "deliveries": boolean;
@@ -293,6 +303,7 @@ export interface Schemas {
             "check_unit_cents"?: number;
             "required_check_unit_cents"?: number;
             "required_check_allowance"?: number;
+            "unchanged_unit_cents"?: number;
             "related_block_cents"?: number;
             "undelivered_unit_cents"?: number;
             "retail_rate"?: {
@@ -329,6 +340,7 @@ export interface Schemas {
         "signed_up": number;
         "rewarded": number;
         "earned_cents": number;
+        "partner"?: (Schemas["CapacityPartnerData"] | null);
     };
     "CapacityReferralVisitData": {
         "attributed": boolean;
@@ -368,6 +380,31 @@ export interface Schemas {
         "calendar_schedule"?: (Schemas["CalendarSchedule"] | null);
         "valid_until": string;
     };
+    "CapacityStartData": {
+        "idempotency_key": string;
+        "state": "reading" | "started" | "needs_edit" | "above_maximum" | "failed";
+        "message"?: (string | null);
+        "read_back"?: (string | null);
+        "maximum_cents"?: (number | null);
+        "find_id"?: (string | null);
+        "retry_after_seconds"?: (number | null);
+        "queue_position"?: (number | null);
+    };
+    "CapacityStartRequest": {
+        "q"?: (string | null);
+        "rows"?: (Array<{
+            [key: string]: (string | number | boolean | null);
+        }> | null);
+        "fields"?: (Array<string> | null);
+        "requested_units"?: number;
+        "confirm_max_cents": number;
+        "maximum_price_usd"?: (number | null);
+        "idempotency_key": string;
+        "locale"?: string;
+        "callback_url"?: (string | null);
+        "callback_on"?: "start" | "done";
+        "one_row_per"?: (string | null);
+    };
     "CapacityTrialEndingData": {
         "event"?: "trial_ending";
         "expires_at": string;
@@ -421,6 +458,20 @@ export interface Schemas {
         "source_collection_ids"?: (Array<string> | null);
         "bbox"?: (Array<unknown> | null);
     };
+    "CollectionShareData": {
+        "id": string;
+        "snapshot_id": string;
+        "public_url": string;
+        "created_at": string;
+        "expires_at"?: (string | null);
+        "revoked": boolean;
+        "allow_export": boolean;
+        "row_count": number;
+    };
+    "CollectionShareInput": {
+        "expires_days"?: (number | null);
+        "allow_export"?: boolean;
+    };
     "CombineCollectionsInput": {
         "request_id": string;
         "name": string;
@@ -451,7 +502,7 @@ export interface Schemas {
         "billed_units"?: Array<Schemas["BilledUnit"]>;
         "shortfall"?: (Schemas["Shortfall"] | null);
     };
-    "CompilerStatus": "runnable" | "needs_edit" | "rejected" | "capability_pending" | "compiler_unavailable" | "unquoted_plan";
+    "CompilerStatus": "runnable" | "needs_edit" | "rejected" | "capability_pending" | "compiler_unavailable" | "unquoted_plan" | "pending";
     "ConditionGrade": {
         "part_id": string;
         "field_id": (string | null);
@@ -470,6 +521,12 @@ export interface Schemas {
         "name": string;
         "project_id"?: (string | null);
     };
+    "CoreEntity": {
+        "name": string;
+        "url": string;
+        "description": string;
+        "request": string;
+    };
     "CountComparison": {
         "op": "gte" | "gt" | "lte" | "lt" | "eq" | "ne";
         "value": number;
@@ -588,13 +645,14 @@ export interface Schemas {
         "platforms"?: Array<string>;
         "searches"?: Array<string>;
         "role_phrases"?: Array<string>;
+        "record_words"?: Array<string>;
         "seed_identifiers"?: {
             [key: string]: string;
         };
     };
     "DisplayAbsence": "Not published" | "Couldn't check";
-    "EntityKind": "place" | "creator" | "organization" | "storefront_product" | "app_listing" | "job_posting" | "scholarly_work" | "tender" | "grant" | "software_repository" | "software_package" | "dataset" | "clinical_trial" | "regulatory_document" | "vulnerability" | "book" | "podcast" | "web_page" | "knowledge_entity" | "person";
-    "EntityType": "local_business" | "creator" | "organization" | "storefront_product" | "app_listing" | "job_posting" | "scholarly_work" | "tender" | "grant" | "software_repository" | "software_package" | "dataset" | "clinical_trial" | "regulatory_document" | "vulnerability" | "book" | "podcast" | "web_page" | "knowledge_entity" | "person";
+    "EntityKind": string;
+    "EntityType": string;
     "EquivalenceRecord": {
         "assessment_id": string;
         "provider": string;
@@ -613,7 +671,7 @@ export interface Schemas {
             [key: string]: unknown;
         };
     };
-    "ErrorCode": "unsupported_query" | "unsupported_predicate" | "unsupported_entity_family" | "ambiguous_geo" | "capability_pending" | "source_blocked" | "challenge_page" | "unquoted_plan" | "compiler_unavailable" | "parse_failed" | "payments_not_live" | "capacity" | "kill_switch" | "internal_failure" | "plan_required";
+    "ErrorCode": "unsupported_query" | "unsupported_predicate" | "unsupported_entity_family" | "ambiguous_geo" | "capability_pending" | "source_blocked" | "challenge_page" | "unquoted_plan" | "compiler_unavailable" | "parse_failed" | "payments_not_live" | "capacity" | "kill_switch" | "internal_failure" | "plan_required" | "invalid_token";
     "ErrorEnvelope": {
         "error": Schemas["ErrorBody"];
     };
@@ -655,6 +713,25 @@ export interface Schemas {
     "ExportRequest": {
         "format": Schemas["ExportFormat"];
     };
+    "ExtractPage": {
+        "request_id": string;
+        "results": Array<Schemas["ExtractedPage"]>;
+        "took_ms": number;
+        "price_usd": number;
+    };
+    "ExtractRequest": {
+        "urls": Array<string>;
+        "format"?: "markdown" | "text";
+    };
+    "ExtractedPage": {
+        "url": string;
+        "status": "ok" | "blocked" | "not_found" | "empty" | "unsupported" | "invalid_url" | "failed";
+        "title": (string | null);
+        "text": string;
+        "published": (string | null);
+        "read_from"?: ("live" | "site" | "archive" | null);
+        "captured_at"?: (string | null);
+    };
     "FieldObservation": {
         "entity_id": string;
         "field_id": string;
@@ -674,6 +751,10 @@ export interface Schemas {
         "source_pointer"?: (string | null);
         "source_response_sha256"?: (string | null);
         "source_time"?: (Schemas["EvidenceTime"] | null);
+        "source_raw"?: ({
+            [key: string]: unknown;
+        } | null);
+        "capability_id"?: (string | null);
     };
     "FileImportCommand": {
         "import_id": string;
@@ -748,6 +829,9 @@ export interface Schemas {
         "accepted_count": number;
         "rows": Array<Schemas["AcceptedRow"]>;
         "possible"?: Array<Schemas["PossibleRow"]>;
+        "flat_rows"?: Array<{
+            [key: string]: unknown;
+        }>;
         "entitlement": string;
         "commerce"?: (Schemas["CommerceData"] | null);
         "next_cursor"?: (string | null);
@@ -1142,6 +1226,7 @@ export interface Schemas {
     };
     "ParseResult": {
         "retained"?: (Schemas["RetainedRequest"] | null);
+        "core_entity"?: (Schemas["CoreEntity"] | null);
         "grading"?: (Schemas["ReadingGrade"] | null);
         "understanding"?: (Schemas["Understanding"] | null);
         "decision_id"?: (string | null);
@@ -1152,6 +1237,8 @@ export interface Schemas {
         "compiler_version": string;
         "ast_hash": (string | null);
         "canonical_sentence": (string | null);
+        "notice"?: (string | null);
+        "read_back"?: (string | null);
     };
     "PasskeyComplete": {
         "challenge_id": string;
@@ -1353,6 +1440,9 @@ export interface Schemas {
         "output_fields"?: Array<Schemas["OutputField"]>;
         "worded_conditions"?: Array<Schemas["WordedCondition"]>;
         "worded_outputs"?: Array<Schemas["WordedOutput"]>;
+        "contact_off"?: Array<"email" | "phone">;
+        "record_fields"?: Array<string>;
+        "each_location"?: boolean;
         "sort": Array<Schemas["SortKey"]>;
         "locale": string;
         "inferred": Array<Schemas["InferredClause"]>;
@@ -1941,6 +2031,7 @@ export interface Schemas {
         "source_find_id"?: (string | null);
         "project_id"?: (string | null);
         "context"?: string;
+        "q"?: (string | null);
     } & ({
         "ast": NonNullable<unknown>;
         "source_find_id"?: null;
@@ -1993,10 +2084,12 @@ export interface Schemas {
         "ast": Schemas["QueryAst"];
         "name"?: (string | null);
         "context"?: (string | null);
+        "q"?: (string | null);
     };
     "SseComplete": {
         "row_count": number;
         "stop_reason": Schemas["StopReason"];
+        "message"?: (string | null);
     };
     "SseError": {
         "code": Schemas["ErrorCode"];
@@ -2055,7 +2148,7 @@ export interface Schemas {
     "SseZero": {
         "cause": string;
     };
-    "StopReason": "complete_target" | "saturated_discovery" | "budget_reserved_exhausted" | "wall_clock" | "fetch_count" | "source_blocked" | "unsupported_predicate" | "zero_after_filters" | "user_cancel" | "capacity";
+    "StopReason": "complete_target" | "saturated_discovery" | "budget_reserved_exhausted" | "wall_clock" | "fetch_count" | "source_blocked" | "unsupported_predicate" | "zero_after_filters" | "user_cancel" | "capacity" | "model_unavailable";
     "StoreCardTransferRequest": {
         "plan_id": string;
         "idempotency_key": string;
@@ -2167,6 +2260,126 @@ export interface Schemas {
         "expirationTime"?: ((number) | null);
         "name": string;
     };
+    "WebSearchAnswer": {
+        "id"?: (string | null);
+        "request_id": string;
+        "query": string;
+        "kind": "list" | "fact";
+        "columns": Array<string>;
+        "answer": (Schemas["WebSearchValue"] | null);
+        "rows": Array<Schemas["WebSearchRow"]>;
+        "sources": Array<Schemas["WebSearchSource"]>;
+        "handoff": (Schemas["WebSearchHandoff"] | null);
+        "took_ms": number;
+        "price_usd": number;
+        "passages"?: (Array<Schemas["WebSearchPassage"]> | null);
+        "request": string;
+        "created_at": string;
+    };
+    "WebSearchAnswerPage": {
+        "results": Array<Schemas["WebSearchAnswerSummary"]>;
+        "next_cursor": (string | null);
+    };
+    "WebSearchAnswerSummary": {
+        "id": string;
+        "request": string;
+        "created_at": string;
+        "rows": number;
+        "answer": (string | null);
+        "source"?: (string | null);
+        "sources"?: Array<Schemas["WebSearchCited"]>;
+        "list": boolean;
+        "kind": "list" | "fact";
+    };
+    "WebSearchBatchPage": {
+        "results": Array<Schemas["WebSearchBatchResult"]>;
+        "took_ms": number;
+        "price_usd": number;
+    };
+    "WebSearchBatchRequest": {
+        "questions": Array<Schemas["WebSearchQuestion"]>;
+    };
+    "WebSearchBatchResult": {
+        "request_id": string;
+        "status": number;
+        "data": (Schemas["WebSearchPage"] | null);
+        "error": (Schemas["ErrorBody"] | null);
+        "retry_after_s"?: (number | null);
+    };
+    "WebSearchCall": {
+        "method": "POST";
+        "path": "/v1/parse";
+        "body": {
+            [key: string]: unknown;
+        };
+    };
+    "WebSearchCited": {
+        "url": string;
+        "title": string;
+        "site": string;
+    };
+    "WebSearchHandoff": {
+        "line": string;
+        "request": string;
+        "rows_estimated": number;
+        "rows_basis": "request" | "page" | "seen";
+        "count_page": (string | null);
+        "next": Schemas["WebSearchNext"];
+    };
+    "WebSearchNext": {
+        "tool": "compile";
+        "arguments": {
+            [key: string]: unknown;
+        };
+        "http": Schemas["WebSearchCall"];
+    };
+    "WebSearchPage": {
+        "id"?: (string | null);
+        "request_id": string;
+        "query": string;
+        "kind": "list" | "fact";
+        "columns": Array<string>;
+        "answer": (Schemas["WebSearchValue"] | null);
+        "rows": Array<Schemas["WebSearchRow"]>;
+        "sources": Array<Schemas["WebSearchSource"]>;
+        "handoff": (Schemas["WebSearchHandoff"] | null);
+        "took_ms": number;
+        "price_usd": number;
+        "passages"?: (Array<Schemas["WebSearchPassage"]> | null);
+    };
+    "WebSearchPassage": {
+        "url": string;
+        "title": string;
+        "text": string;
+    };
+    "WebSearchQuestion": {
+        "q": string;
+        "id"?: (string | null);
+    };
+    "WebSearchRow": {
+        "name": string;
+        "page": string;
+        "snippet": string;
+        "probability": number;
+        "fields": {
+            [key: string]: Schemas["WebSearchValue"];
+        };
+        "sources"?: Array<number>;
+    };
+    "WebSearchSource": {
+        "url": string;
+        "title": string;
+        "site": string;
+        "snippet": string;
+        "cited": boolean;
+        "published"?: (string | null);
+    };
+    "WebSearchValue": {
+        "value": string;
+        "page": string;
+        "seen_at"?: (string | null);
+        "confirmed"?: (boolean | null);
+    };
     "WebSourceCell": {
         "source_url": string;
         "response_sha256": string;
@@ -2243,7 +2456,7 @@ export interface Schemas {
         "detail_id": string;
         "words": string;
         "description": string;
-        "value_type"?: "text" | "number" | "date" | "url" | "email" | "phone" | "yes_no";
+        "value_type"?: "text" | "number" | "date" | "url" | "email" | "phone" | "yes_no" | "place";
         "required"?: boolean;
     };
     "WorkspaceAuditEvent": {
@@ -2470,6 +2683,7 @@ export interface Schemas {
         "snippet": string;
         "project_id"?: (string | null);
         "collection_id"?: (string | null);
+        "find_id"?: (string | null);
         "record_id"?: (string | null);
         "note_id"?: (string | null);
         "imported"?: (boolean | null);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specstream/sdk",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "description": "TypeScript client for building lead lists and company lists from the live web. Every match comes with its source, priced before it runs.",
   "type": "module",
   "main": "./dist/index.js",
@@ -49,11 +49,11 @@
   "homepage": "https://specstream.ai/docs/sdk",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Specstreamai/specstream-tools.git",
+    "url": "git+https://github.com/specstream/specstream-tools.git",
     "directory": "packages/sdk-ts"
   },
   "bugs": {
-    "url": "https://github.com/Specstreamai/specstream-tools/issues"
+    "url": "https://github.com/specstream/specstream-tools/issues"
   },
   "publishConfig": {
     "access": "public"