casedev 0.3.0 → 0.4.1

package/resources/legal/v1.d.ts

@@ -0,0 +1,572 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class V1 extends APIResource {
+    /**
+     * Search for legal sources including cases, statutes, and regulations from
+     * authoritative legal databases. Returns ranked candidates. Always verify with
+     * legal.verify() before citing.
+     */
+    find(body: V1FindParams, options?: RequestOptions): APIPromise<V1FindResponse>;
+    /**
+     * Parses legal citations from text and returns structured Bluebook components
+     * (case name, reporter, volume, page, year, court). Accepts either a single
+     * citation or a full text block.
+     */
+    getCitations(body: V1GetCitationsParams, options?: RequestOptions): APIPromise<V1GetCitationsResponse>;
+    /**
+     * Extract all legal citations and references from a document URL. Returns
+     * structured citation data including case citations, statute references, and
+     * regulatory citations.
+     */
+    getCitationsFromURL(body: V1GetCitationsFromURLParams, options?: RequestOptions): APIPromise<V1GetCitationsFromURLResponse>;
+    /**
+     * Retrieve the full text content of a legal document. Use after verifying the
+     * source with legal.verify(). Returns complete text with optional highlights and
+     * AI summary.
+     */
+    getFullText(body: V1GetFullTextParams, options?: RequestOptions): APIPromise<V1GetFullTextResponse>;
+    /**
+     * Search for a jurisdiction by name. Returns matching jurisdictions with their IDs
+     * for use in legal.find() and other legal research endpoints.
+     */
+    listJurisdictions(body: V1ListJurisdictionsParams, options?: RequestOptions): APIPromise<V1ListJurisdictionsResponse>;
+    /**
+     * Perform comprehensive legal research with multiple query variations. Uses
+     * advanced deep search to find relevant sources across different phrasings of the
+     * legal issue.
+     */
+    research(body: V1ResearchParams, options?: RequestOptions): APIPromise<V1ResearchResponse>;
+    /**
+     * Find cases and documents similar to a given legal source. Useful for finding
+     * citing cases, related precedents, or similar statutes.
+     */
+    similar(body: V1SimilarParams, options?: RequestOptions): APIPromise<V1SimilarResponse>;
+    /**
+     * Validates legal citations against authoritative case law sources (CourtListener
+     * database of ~10M cases). Returns verification status and case metadata for each
+     * citation found in the input text. Accepts either a single citation or a full
+     * text block containing multiple citations.
+     */
+    verify(body: V1VerifyParams, options?: RequestOptions): APIPromise<V1VerifyResponse>;
+}
+export interface V1FindResponse {
+    candidates?: Array<V1FindResponse.Candidate>;
+    /**
+     * Number of candidates found
+     */
+    found?: number;
+    /**
+     * Usage guidance
+     */
+    hint?: string;
+    /**
+     * Jurisdiction filter applied
+     */
+    jurisdiction?: string;
+    /**
+     * Original search query
+     */
+    query?: string;
+}
+export declare namespace V1FindResponse {
+    interface Candidate {
+        /**
+         * Text excerpt from the document
+         */
+        snippet?: string;
+        /**
+         * Domain of the source
+         */
+        source?: string;
+        /**
+         * Title of the document
+         */
+        title?: string;
+        /**
+         * URL of the legal source
+         */
+        url?: string;
+    }
+}
+export interface V1GetCitationsResponse {
+    citations?: Array<V1GetCitationsResponse.Citation>;
+}
+export declare namespace V1GetCitationsResponse {
+    interface Citation {
+        /**
+         * Structured Bluebook components. Null if citation format is not recognized.
+         */
+        components?: Citation.Components | null;
+        /**
+         * Whether citation was found in CourtListener database
+         */
+        found?: boolean;
+        /**
+         * Normalized citation string
+         */
+        normalized?: string;
+        /**
+         * Original citation as found in text
+         */
+        original?: string;
+        span?: Citation.Span;
+    }
+    namespace Citation {
+        /**
+         * Structured Bluebook components. Null if citation format is not recognized.
+         */
+        interface Components {
+            /**
+             * Case name, e.g., "Bush v. Gore"
+             */
+            caseName?: string;
+            /**
+             * Court identifier
+             */
+            court?: string;
+            /**
+             * Starting page number
+             */
+            page?: number;
+            /**
+             * Pin cite (specific page)
+             */
+            pinCite?: number;
+            /**
+             * Reporter abbreviation, e.g., "U.S."
+             */
+            reporter?: string;
+            /**
+             * Volume number
+             */
+            volume?: number;
+            /**
+             * Decision year
+             */
+            year?: number;
+        }
+        interface Span {
+            end?: number;
+            start?: number;
+        }
+    }
+}
+export interface V1GetCitationsFromURLResponse {
+    citations?: V1GetCitationsFromURLResponse.Citations;
+    /**
+     * External links found in the document
+     */
+    externalLinks?: Array<string>;
+    /**
+     * Usage guidance
+     */
+    hint?: string;
+    /**
+     * Document title
+     */
+    title?: string;
+    /**
+     * Total citations found
+     */
+    totalCitations?: number;
+    /**
+     * Source document URL
+     */
+    url?: string;
+}
+export declare namespace V1GetCitationsFromURLResponse {
+    interface Citations {
+        cases?: Array<Citations.Case>;
+        regulations?: Array<Citations.Regulation>;
+        statutes?: Array<Citations.Statute>;
+    }
+    namespace Citations {
+        interface Case {
+            /**
+             * The citation string
+             */
+            citation?: string;
+            /**
+             * Number of occurrences
+             */
+            count?: number;
+            /**
+             * Citation type (usReporter, federalReporter, etc.)
+             */
+            type?: string;
+        }
+        interface Regulation {
+            /**
+             * The citation string
+             */
+            citation?: string;
+            /**
+             * Number of occurrences
+             */
+            count?: number;
+            /**
+             * Citation type (cfr)
+             */
+            type?: string;
+        }
+        interface Statute {
+            /**
+             * The citation string
+             */
+            citation?: string;
+            /**
+             * Number of occurrences
+             */
+            count?: number;
+            /**
+             * Citation type (usc)
+             */
+            type?: string;
+        }
+    }
+}
+export interface V1GetFullTextResponse {
+    /**
+     * Author or court
+     */
+    author?: string | null;
+    /**
+     * Total characters in text
+     */
+    characterCount?: number;
+    /**
+     * Highlighted relevant passages
+     */
+    highlights?: Array<string>;
+    /**
+     * Publication date
+     */
+    publishedDate?: string | null;
+    /**
+     * AI-generated summary
+     */
+    summary?: string | null;
+    /**
+     * Full document text
+     */
+    text?: string;
+    /**
+     * Document title
+     */
+    title?: string;
+    /**
+     * Document URL
+     */
+    url?: string;
+}
+export interface V1ListJurisdictionsResponse {
+    /**
+     * Number of matching jurisdictions
+     */
+    found?: number;
+    /**
+     * Usage guidance
+     */
+    hint?: string;
+    jurisdictions?: Array<V1ListJurisdictionsResponse.Jurisdiction>;
+    /**
+     * Original search query
+     */
+    query?: string;
+}
+export declare namespace V1ListJurisdictionsResponse {
+    interface Jurisdiction {
+        /**
+         * Jurisdiction ID to use in other endpoints
+         */
+        id?: string;
+        /**
+         * Jurisdiction level
+         */
+        level?: 'federal' | 'state' | 'county' | 'municipal';
+        /**
+         * Full jurisdiction name
+         */
+        name?: string;
+        /**
+         * State abbreviation (if applicable)
+         */
+        state?: string | null;
+    }
+}
+export interface V1ResearchResponse {
+    /**
+     * Additional queries used
+     */
+    additionalQueries?: Array<string> | null;
+    candidates?: Array<V1ResearchResponse.Candidate>;
+    /**
+     * Number of candidates found
+     */
+    found?: number;
+    /**
+     * Usage guidance
+     */
+    hint?: string;
+    /**
+     * Jurisdiction filter applied
+     */
+    jurisdiction?: string;
+    /**
+     * Primary search query
+     */
+    query?: string;
+    /**
+     * Search type used (deep)
+     */
+    searchType?: string;
+}
+export declare namespace V1ResearchResponse {
+    interface Candidate {
+        /**
+         * Highlighted relevant passages
+         */
+        highlights?: Array<string>;
+        /**
+         * Publication date
+         */
+        publishedDate?: string | null;
+        /**
+         * Text excerpt from the document
+         */
+        snippet?: string;
+        /**
+         * Domain of the source
+         */
+        source?: string;
+        /**
+         * Title of the document
+         */
+        title?: string;
+        /**
+         * URL of the legal source
+         */
+        url?: string;
+    }
+}
+export interface V1SimilarResponse {
+    /**
+     * Number of similar sources found
+     */
+    found?: number;
+    /**
+     * Usage guidance
+     */
+    hint?: string;
+    /**
+     * Jurisdiction filter applied
+     */
+    jurisdiction?: string;
+    similarSources?: Array<V1SimilarResponse.SimilarSource>;
+    /**
+     * Original source URL
+     */
+    sourceUrl?: string;
+}
+export declare namespace V1SimilarResponse {
+    interface SimilarSource {
+        /**
+         * Publication date
+         */
+        publishedDate?: string | null;
+        /**
+         * Text excerpt from the document
+         */
+        snippet?: string;
+        /**
+         * Domain of the source
+         */
+        source?: string;
+        /**
+         * Title of the document
+         */
+        title?: string;
+        /**
+         * URL of the similar source
+         */
+        url?: string;
+    }
+}
+export interface V1VerifyResponse {
+    citations?: Array<V1VerifyResponse.Citation>;
+    summary?: V1VerifyResponse.Summary;
+}
+export declare namespace V1VerifyResponse {
+    interface Citation {
+        /**
+         * Multiple candidates (when multiple_matches or heuristic verification)
+         */
+        candidates?: Array<Citation.Candidate>;
+        /**
+         * Case metadata (when verified)
+         */
+        case?: Citation.Case;
+        /**
+         * Confidence score (1.0 for CourtListener, heuristic score for fallback).
+         */
+        confidence?: number;
+        /**
+         * Normalized citation string
+         */
+        normalized?: string;
+        /**
+         * Original citation as found in text
+         */
+        original?: string;
+        span?: Citation.Span;
+        status?: 'verified' | 'not_found' | 'multiple_matches';
+        /**
+         * Source of verification result (heuristic for fallback matches).
+         */
+        verificationSource?: 'courtlistener' | 'heuristic';
+    }
+    namespace Citation {
+        interface Candidate {
+            court?: string;
+            dateDecided?: string;
+            name?: string;
+            url?: string;
+        }
+        /**
+         * Case metadata (when verified)
+         */
+        interface Case {
+            id?: number;
+            court?: string;
+            dateDecided?: string;
+            docketNumber?: string;
+            name?: string;
+            parallelCitations?: Array<string>;
+            shortName?: string;
+            url?: string;
+        }
+        interface Span {
+            end?: number;
+            start?: number;
+        }
+    }
+    interface Summary {
+        /**
+         * Citations with multiple possible matches
+         */
+        multipleMatches?: number;
+        /**
+         * Citations not found in database
+         */
+        notFound?: number;
+        /**
+         * Total citations found
+         */
+        total?: number;
+        /**
+         * Citations verified against real cases
+         */
+        verified?: number;
+    }
+}
+export interface V1FindParams {
+    /**
+     * Search query (e.g., "fair use copyright", "Miranda rights")
+     */
+    query: string;
+    /**
+     * Optional jurisdiction ID from resolveJurisdiction (e.g., "california",
+     * "us-federal")
+     */
+    jurisdiction?: string;
+    /**
+     * Number of results 1-25 (default: 10)
+     */
+    numResults?: number;
+}
+export interface V1GetCitationsParams {
+    /**
+     * Text containing citations to extract. Can be a single citation (e.g., "531 U.S.
+     * 98") or a full document with multiple citations.
+     */
+    text: string;
+}
+export interface V1GetCitationsFromURLParams {
+    /**
+     * URL of the legal document to extract citations from
+     */
+    url: string;
+}
+export interface V1GetFullTextParams {
+    /**
+     * URL of the verified legal document
+     */
+    url: string;
+    /**
+     * Optional query to extract relevant highlights (e.g., "What is the holding?")
+     */
+    highlightQuery?: string;
+    /**
+     * Maximum characters to return (default: 10000, max: 50000)
+     */
+    maxCharacters?: number;
+    /**
+     * Optional query for generating a summary (e.g., "Summarize the key ruling")
+     */
+    summaryQuery?: string;
+}
+export interface V1ListJurisdictionsParams {
+    /**
+     * Jurisdiction name (e.g., "California", "US Federal", "NY")
+     */
+    name: string;
+}
+export interface V1ResearchParams {
+    /**
+     * Primary search query
+     */
+    query: string;
+    /**
+     * Additional query variations to search (e.g., different phrasings of the legal
+     * issue)
+     */
+    additionalQueries?: Array<string>;
+    /**
+     * Optional jurisdiction ID from resolveJurisdiction
+     */
+    jurisdiction?: string;
+    /**
+     * Number of results 1-25 (default: 10)
+     */
+    numResults?: number;
+}
+export interface V1SimilarParams {
+    /**
+     * URL of a legal document to find similar sources for
+     */
+    url: string;
+    /**
+     * Optional jurisdiction ID to filter results
+     */
+    jurisdiction?: string;
+    /**
+     * Number of results 1-25 (default: 10)
+     */
+    numResults?: number;
+    /**
+     * Optional ISO date to find only newer documents (e.g., "2020-01-01")
+     */
+    startPublishedDate?: string;
+}
+export interface V1VerifyParams {
+    /**
+     * Text containing citations to verify. Can be a single citation (e.g., "531 U.S.
+     * 98") or a full document with multiple citations.
+     */
+    text: string;
+}
+export declare namespace V1 {
+    export { type V1FindResponse as V1FindResponse, type V1GetCitationsResponse as V1GetCitationsResponse, type V1GetCitationsFromURLResponse as V1GetCitationsFromURLResponse, type V1GetFullTextResponse as V1GetFullTextResponse, type V1ListJurisdictionsResponse as V1ListJurisdictionsResponse, type V1ResearchResponse as V1ResearchResponse, type V1SimilarResponse as V1SimilarResponse, type V1VerifyResponse as V1VerifyResponse, type V1FindParams as V1FindParams, type V1GetCitationsParams as V1GetCitationsParams, type V1GetCitationsFromURLParams as V1GetCitationsFromURLParams, type V1GetFullTextParams as V1GetFullTextParams, type V1ListJurisdictionsParams as V1ListJurisdictionsParams, type V1ResearchParams as V1ResearchParams, type V1SimilarParams as V1SimilarParams, type V1VerifyParams as V1VerifyParams, };
+}
+//# sourceMappingURL=v1.d.ts.map

package/resources/legal/v1.d.ts.map

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

package/resources/legal/v1.js

@@ -0,0 +1,72 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.V1 = void 0;
+const resource_1 = require("../../core/resource.js");
+class V1 extends resource_1.APIResource {
+    /**
+     * Search for legal sources including cases, statutes, and regulations from
+     * authoritative legal databases. Returns ranked candidates. Always verify with
+     * legal.verify() before citing.
+     */
+    find(body, options) {
+        return this._client.post('/legal/v1/find', { body, ...options });
+    }
+    /**
+     * Parses legal citations from text and returns structured Bluebook components
+     * (case name, reporter, volume, page, year, court). Accepts either a single
+     * citation or a full text block.
+     */
+    getCitations(body, options) {
+        return this._client.post('/legal/v1/citations', { body, ...options });
+    }
+    /**
+     * Extract all legal citations and references from a document URL. Returns
+     * structured citation data including case citations, statute references, and
+     * regulatory citations.
+     */
+    getCitationsFromURL(body, options) {
+        return this._client.post('/legal/v1/citations-from-url', { body, ...options });
+    }
+    /**
+     * Retrieve the full text content of a legal document. Use after verifying the
+     * source with legal.verify(). Returns complete text with optional highlights and
+     * AI summary.
+     */
+    getFullText(body, options) {
+        return this._client.post('/legal/v1/full-text', { body, ...options });
+    }
+    /**
+     * Search for a jurisdiction by name. Returns matching jurisdictions with their IDs
+     * for use in legal.find() and other legal research endpoints.
+     */
+    listJurisdictions(body, options) {
+        return this._client.post('/legal/v1/jurisdictions', { body, ...options });
+    }
+    /**
+     * Perform comprehensive legal research with multiple query variations. Uses
+     * advanced deep search to find relevant sources across different phrasings of the
+     * legal issue.
+     */
+    research(body, options) {
+        return this._client.post('/legal/v1/research', { body, ...options });
+    }
+    /**
+     * Find cases and documents similar to a given legal source. Useful for finding
+     * citing cases, related precedents, or similar statutes.
+     */
+    similar(body, options) {
+        return this._client.post('/legal/v1/similar', { body, ...options });
+    }
+    /**
+     * Validates legal citations against authoritative case law sources (CourtListener
+     * database of ~10M cases). Returns verification status and case metadata for each
+     * citation found in the input text. Accepts either a single citation or a full
+     * text block containing multiple citations.
+     */
+    verify(body, options) {
+        return this._client.post('/legal/v1/verify', { body, ...options });
+    }
+}
+exports.V1 = V1;
+//# sourceMappingURL=v1.js.map

package/resources/legal/v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1.js","sourceRoot":"","sources":["../../src/resources/legal/v1.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAIlD,MAAa,EAAG,SAAQ,sBAAW;IACjC;;;;OAIG;IACH,IAAI,CAAC,IAAkB,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,IAA0B,EAAE,OAAwB;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;OAIG;IACH,mBAAmB,CACjB,IAAiC,EACjC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,IAAyB,EAAE,OAAwB;QAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;OAGG;IACH,iBAAiB,CACf,IAA+B,EAC/B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,IAAsB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,IAAqB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAoB,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;CACF;AA7ED,gBA6EC"}