Demoing the Wise Isaacus

\n Paste any legal document URL and watch\n Kanon 2 Enricher\n transform raw text into a structured knowledge graph — entities, segments, citations, and more.\n

\n\n

\n Document URL\n

\n \n \n

\n Use Jina\n \n

\n\n

Try a complex document

\n\n

Enrichment Results

\n \n \n

\n\n

\n \n \n

\n\n

\n \n \n

\n\n\n\n\n\n`;\n}","isaacus",[132],"e8bcd5c0-05d0-11f1-ab3f-42dde27851f2","ilgs_v1.ts","3cd8773c-05d0-11f1-8939-42dde27851f2",77,["D",1770653024106],3,"// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.\n\n/**\n * A cross-reference within the document pointing to one or more segments.\n */\nexport interface Crossreference {\n /**\n * The unique identifier of the earliest segment in the span of segments being\n * cross-referenced with ties broken in favor of the least-nested (i.e., largest)\n * segment. If the cross-reference points to a single segment, `start` and `end`\n * will be identical.\n */\n start: string;\n\n /**\n * The unique identifier of the latest segment in the span of segments being\n * cross-referenced with ties broken in favor of the least-nested (i.e., largest)\n * segment. If the cross-reference points to a single segment, `start` and `end`\n * will be identical.\n */\n end: string;\n\n /**\n * A zero-based, half-open span into the Unicode code point space of input text.\n *\n * All spans are globally laminar and well-nested similar to XML—it is impossible\n * for any two spans to partially overlap; they can only be disjoint, adjacent, or\n * wholly nested. Spans of the exact same type (e.g., segments) will never be\n * duplicated.\n *\n * A span cannot be empty and will never start or end at whitespace.\n *\n * Note that, when using programming languages other than Python (which uses\n * zero-based, half-open, Unicode code point-spaced string indexing), indices may\n * need to be translated accordingly (for example, JavaScript slices into UTF-16\n * code units instead of Unicode code points).\n */\n span: Span;\n}\n\n/**\n * A date identified in a document belonging to one of the following types:\n * `creation`, `signature`, `effective`, `expiry`, `delivery`, `renewal`,\n * `payment`, `birth`, or `death`.\n *\n * Only Gregorian dates between the years 1000 and 9999 (inclusive) fitting into\n * one of the supported date types are extractable.\n */\nexport interface Date {\n /**\n * The date in ISO 8601 format (YYYY-MM-DD).\n */\n value: string;\n\n /**\n * The type of the date, being one of `creation`, `signature`, `effective`,\n * `expiry`, `delivery`, `renewal`, `payment`, `birth`, or `death`. If a date is\n * mentioned in a document that does not fit into a supported type, it will not be\n * extracted.\n *\n * `creation` denotes the date the document was created. There may only be one\n * `creation` date per document.\n *\n * `signature` denotes the date the document was signed.\n *\n * `effective` denotes the date when the document or a part thereof comes into\n * effect (e.g., commencement or enactment dates).\n *\n * `expiry` denotes the date when the document or a part thereof is no longer in\n * effect.\n *\n * `delivery` denotes the date when goods or services are to be delivered under the\n * document.\n *\n * `renewal` denotes the date when one or more of the document's terms are to be\n * renewed.\n *\n * `payment` denotes the date when payment is to be made under the document.\n *\n * `birth` denotes the birth date of a natural person or establishment (e.g.,\n * incorporation) date of a non-natural legal person identified in the document.\n * There can only be one `birth` date linked to a single person and all `birth`\n * dates must be linked to a person. A person's `birth` date will never be after\n * their `death` date.\n *\n * `death` denotes the death date of a natural person or dissolution date of a\n * non-natural legal person identified in the document. There can only be one\n * `death` date linked to a single person and all `death` dates must be linked to a\n * person. A person's `death` date will never be before their `birth` date.\n */\n type:\n | \"creation\"\n | \"signature\"\n | \"effective\"\n | \"expiry\"\n | \"delivery\"\n | \"renewal\"\n | \"payment\"\n | \"birth\"\n | \"death\";\n\n /**\n * A unique identifier for a legal person in the format `per:{index}` where\n * `{index}` is a non-negative incrementing integer starting from zero.\n */\n person: string | null;\n\n /**\n * An array of one or more spans within the document's text where the date is\n * mentioned.\n */\n mentions: Array;\n}\n\n/**\n * The document enriched into version 1.0.0 of the Isaacus Legal Graph Schema\n * (IGLS).\n *\n * All spans in an enriched document graph are indexed into the Unicode code point\n * space of a source document.\n *\n * The start and end indices of spans are zero-based (i.e., the first Unicode code\n * point in the document is at index 0) and half-open (i.e., the end index is\n * exclusive).\n *\n * All spans are globally laminar and well-nested similar to XML—it is impossible\n * for any two spans to partially overlap; they can only be disjoint, adjacent, or\n * wholly nested.\n *\n * Spans of the exact same type (e.g., segments) will never be duplicated.\n *\n * Spans cannot be empty and will never start or end at whitespace.\n *\n * When using programming languages other than Python (which uses zero-based,\n * half-open, Unicode code point-spaced string indexing), indices may need to be\n * translated accordingly (for example, JavaScript slices into UTF-16 code units\n * instead of Unicode code points).\n */\nexport interface Document {\n /**\n * The text of the document.\n */\n text: string;\n\n /**\n * A zero-based, half-open span into the Unicode code point space of input text.\n *\n * All spans are globally laminar and well-nested similar to XML—it is impossible\n * for any two spans to partially overlap; they can only be disjoint, adjacent, or\n * wholly nested. Spans of the exact same type (e.g., segments) will never be\n * duplicated.\n *\n * A span cannot be empty and will never start or end at whitespace.\n *\n * Note that, when using programming languages other than Python (which uses\n * zero-based, half-open, Unicode code point-spaced string indexing), indices may\n * need to be translated accordingly (for example, JavaScript slices into UTF-16\n * code units instead of Unicode code points).\n */\n title: Span | null;\n\n /**\n * A zero-based, half-open span into the Unicode code point space of input text.\n *\n * All spans are globally laminar and well-nested similar to XML—it is impossible\n * for any two spans to partially overlap; they can only be disjoint, adjacent, or\n * wholly nested. Spans of the exact same type (e.g., segments) will never be\n * duplicated.\n *\n * A span cannot be empty and will never start or end at whitespace.\n *\n * Note that, when using programming languages other than Python (which uses\n * zero-based, half-open, Unicode code point-spaced string indexing), indices may\n * need to be translated accordingly (for example, JavaScript slices into UTF-16\n * code units instead of Unicode code points).\n */\n subtitle: Span | null;\n\n /**\n * The type of the document, being one of `statute`, `regulation`, `decision`,\n * `contract`, or `other`.\n *\n * `statute` denotes primary legislation such as acts, bills, codes, and\n * constitutions.\n *\n * `regulation` denotes secondary legislation such as rules, statutory instruments,\n * and ordinances.\n *\n * `decision` denotes judicial or quasi-judicial decisions such as court judgments,\n * judicial opinions, and tribunal rulings.\n *\n * `contract` denotes contracts, covenants, and agreements.\n *\n * `other` is used for all other types of legal documents that do not fit into any\n * of the predefined types.\n */\n type: \"statute\" | \"regulation\" | \"decision\" | \"contract\" | \"other\";\n\n /**\n * A jurisdiction code representing a country (via an initial country code) and,\n * optionally, a subdivision within that country (via a subsequent subdivision code\n * prefixed by a hyphen).\n *\n * All 249 ISO 3166-1 alpha-2 country codes are representable in addition to\n * special `INT` and `EU` codes for international and European Union law,\n * respectively.\n *\n * All 5,046 ISO 3166-2 codes are also representable in addition to a special `FED`\n * code for federal law.\n */\n jurisdiction: string | null;\n\n /**\n * An array of segments within the document representing structurally distinct\n * portions of its content.\n */\n segments: Array;\n\n /**\n * An array of cross-references within the document pointing to a single segment or\n * a span of segments.\n */\n crossreferences: Array;\n\n /**\n * An array of locations identified in the document.\n */\n locations: Array;\n\n /**\n * An array of legal persons identified in the document.\n */\n persons: Array;\n\n /**\n * An array of email addresses identified in the document belonging to legal\n * persons.\n *\n * Email addresses mentioned in the document that are not attributable to legal\n * persons will not be extracted.\n */\n emails: Array;\n\n /**\n * An array of websites identified in the document belonging to legal persons.\n *\n * Websites mentioned in the document that are not attributable to legal persons\n * will not be extracted.\n */\n websites: Array;\n\n /**\n * An array of valid phone numbers identified in the document belonging to legal\n * persons.\n *\n * Phone numbers mentioned in the document that are not valid, possible, or\n * attributable to legal persons will not be extracted.\n */\n phone_numbers: Array;\n\n /**\n * An array of identification numbers identified in the document belonging to legal\n * persons.\n *\n * Identification numbers mentioned in the document that are not attributable to\n * legal persons will not be extracted.\n */\n id_numbers: Array;\n\n /**\n * An array of terms assigned definite meanings within the document.\n */\n terms: Array;\n\n /**\n * An array of documents identified within the document.\n */\n external_documents: Array;\n\n /**\n * An array of quotations within the document.\n */\n quotes: Array;\n\n /**\n * An array of dates identified in the document belonging to one of the following\n * types: `creation`, `signature`, `effective`, `expiry`, `delivery`, `renewal`,\n * `payment`, `birth`, or `death`.\n *\n * Only Gregorian dates between the years 1000 and 9999 (inclusive) fitting into\n * one of the supported date types are extractable.\n */\n dates: Array;\n\n /**\n * An array of spans within the document's text constituting headings.\n */\n headings: Array;\n\n /**\n * An array of spans within the document's text constituting non-operative,\n * non-substantive 'junk' content such as headers, footers, page numbers, and OCR\n * artifacts.\n */\n junk: Array;\n\n version: \"ilgs@1\";\n}\n\n/**\n * An email address identified in a document belonging to a legal person.\n *\n * If an email address was mentioned in the document but is not attributable to a\n * legal person, it will not be extracted.\n */\nexport interface Email {\n /**\n * The normalized email address.\n */\n address: string;\n\n /**\n * The unique identifier of the person that this email address belongs to.\n */\n person: string;\n\n /**\n * An array of one or more spans within the document's text where the email address\n * is mentioned.\n */\n mentions: Array;\n}\n\n/**\n * A document identified within another document.\n */\nexport interface ExternalDocument {\n /**\n * The unique identifier of the external document in the format `exd:{index}` where\n * `{index}` is a non-negative incrementing integer starting from zero.\n */\n id: string;\n\n /**\n * A zero-based, half-open span into the Unicode code point space of input text.\n *\n * All spans are globally laminar and well-nested similar to XML—it is impossible\n * for any two spans to partially overlap; they can only be disjoint, adjacent, or\n * wholly nested. Spans of the exact same type (e.g., segments) will never be\n * duplicated.\n *\n * A span cannot be empty and will never start or end at whitespace.\n *\n * Note that, when using programming languages other than Python (which uses\n * zero-based, half-open, Unicode code point-spaced string indexing), indices may\n * need to be translated accordingly (for example, JavaScript slices into UTF-16\n * code units instead of Unicode code points).\n */\n name: Span;\n\n /**\n * The type of the external document, being one of `statute`, `regulation`,\n * `decision`, `contract`, or `other`.\n *\n * `statute` denotes primary legislation such as acts, bills, codes, and\n * constitutions.\n *\n * `regulation` denotes secondary legislation such as rules, statutory instruments,\n * and ordinances.\n *\n * `decision` denotes judicial or quasi-judicial decisions such as court judgments,\n * judicial opinions, and tribunal rulings.\n *\n * `other` is used for all other types of legal documents that do not fit into any\n * of the predefined types.\n */\n type: \"statute\" | \"regulation\" | \"decision\" | \"contract\" | \"other\";\n\n /**\n * A jurisdiction code representing a country (via an initial country code) and,\n * optionally, a subdivision within that country (via a subsequent subdivision code\n * prefixed by a hyphen).\n *\n * All 249 ISO 3166-1 alpha-2 country codes are representable in addition to\n * special `INT` and `EU` codes for international and European Union law,\n * respectively.\n *\n * All 5,046 ISO 3166-2 codes are also representable in addition to a special `FED`\n * code for federal law.\n */\n jurisdiction: string | null;\n\n /**\n * The sentiment of the document towards the external document, being one of\n * `positive`, `mixed`, `negative`, or `neutral`.\n *\n * `positive` indicates that the document expresses a favorable view of the\n * external document whether by endorsing or approving it.\n *\n * `mixed` indicates that the document expresses both favorable and unfavorable\n * views of the external document, for example, by affirming parts of it and\n * disapproving others.\n *\n * `negative` indicates that the document expresses an unfavorable view of the\n * external document whether by criticizing, repealing, overruling, or explicitly\n * contradicting it.\n *\n * `neutral` indicates that the document references the external document without\n * expressing any particular sentiment towards it.\n */\n reception: \"positive\" | \"mixed\" | \"negative\" | \"neutral\";\n\n /**\n * An array of one or more spans within the document's text where the external\n * document is mentioned by name, for example, 'the US Constitution' in 'the Second\n * Amendment to the US Constitution protects freedom of speech'.\n */\n mentions: Array;\n\n /**\n * An array of spans within the document's text where specific parts of the\n * external document are referenced, for example, 'Section 2' in 'as defined in\n * Section 2 of the US Constitution'.\n */\n pinpoints: Array;\n}\n\n/**\n * An identification number mentioned in a document belonging to a legal person.\n *\n * If an identification number was mentioned in the document but is not\n * attributable to a legal person, it will not be extracted.\n */\nexport interface IDNumber {\n /**\n * The identification number.\n */\n number: string;\n\n /**\n * The unique identifier of the person that this identification number belongs to.\n */\n person: string;\n\n /**\n * An array of one or more spans within the document's text where the\n * identification number is mentioned.\n */\n mentions: Array;\n}\n\n/**\n * A location identified within a document.\n */\nexport interface Location {\n /**\n * The unique identifier of the location in the format `loc:{index}` where\n * `{index}` is a non-negative incrementing integer starting from zero.\n */\n id: string;\n\n /**\n * A zero-based, half-open span into the Unicode code point space of input text.\n *\n * All spans are globally laminar and well-nested similar to XML—it is impossible\n * for any two spans to partially overlap; they can only be disjoint, adjacent, or\n * wholly nested. Spans of the exact same type (e.g., segments) will never be\n * duplicated.\n *\n * A span cannot be empty and will never start or end at whitespace.\n *\n * Note that, when using programming languages other than Python (which uses\n * zero-based, half-open, Unicode code point-spaced string indexing), indices may\n * need to be translated accordingly (for example, JavaScript slices into UTF-16\n * code units instead of Unicode code points).\n */\n name: Span;\n\n /**\n * The type of the location, being one of `country`, `state`, `city`, `address`, or\n * `other`.\n */\n type: \"country\" | \"state\" | \"city\" | \"address\" | \"other\";\n\n /**\n * A unique identifier for a location in the format `loc:{index}` where `{index}`\n * is a non-negative incrementing integer starting from zero.\n */\n parent: string | null;\n\n /**\n * The unique identifiers of any 'child' locations having this location as their\n * immediate parent.\n */\n children: Array;\n\n /**\n * An array of one or more spans within the document's text where the location is\n * mentioned.\n */\n mentions: Array;\n}\n\n/**\n * A legal person identified in a document.\n */\nexport interface Person {\n /**\n * The unique identifier of the person in the format `per:{index}` where `{index}`\n * is a non-negative incrementing integer starting from zero.\n */\n id: string;\n\n /**\n * A zero-based, half-open span into the Unicode code point space of input text.\n *\n * All spans are globally laminar and well-nested similar to XML—it is impossible\n * for any two spans to partially overlap; they can only be disjoint, adjacent, or\n * wholly nested. Spans of the exact same type (e.g., segments) will never be\n * duplicated.\n *\n * A span cannot be empty and will never start or end at whitespace.\n *\n * Note that, when using programming languages other than Python (which uses\n * zero-based, half-open, Unicode code point-spaced string indexing), indices may\n * need to be translated accordingly (for example, JavaScript slices into UTF-16\n * code units instead of Unicode code points).\n */\n name: Span;\n\n /**\n * The legal entity type of the person, being one of `natural`, `corporate`, or\n * `politic`.\n *\n * `natural` denotes a human being in their capacity as a natural legal person,\n * including when representing unincorporated entities such as partnerships and\n * trusts.\n *\n * `corporate` denotes a body corporate such as a company, incorporated\n * partnership, or statutory corporation.\n *\n * `politic` denotes a body politic, political entity, or part thereof such as a\n * court, state, government, or intergovernmental organization.\n */\n type: \"natural\" | \"corporate\" | \"politic\";\n\n /**\n * The role of the person in relation to the subject of the document.\n *\n * The following roles are currently supported: | | | | ------------------------ |\n * ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\n * | | `plaintiff` | A party initiating the case that is the subject of the\n * document. | | `petitioner` | A party initiating the petition that is the subject\n * of the document. | | `applicant` | A party initiating the application that is\n * the subject of the document. | | `appellant` | A party appealing the decision\n * that is the subject of the document. | | `appellee` | A party responding to the\n * appeal that is the subject of the document if they are explicitly referred to as\n * an 'appellee'. | | `claimant` | A party making a claim in the case that is the\n * subject of the document. | | `complainant` | A party making a complaint in the\n * case that is the subject of the document. | | `defendant` | A party defending\n * against the case that is the subject of the document. | | `respondent` | A party\n * responding to the petition, appeal, or application that is the subject of the\n * document. | | `prior_authority` | An authority (e.g., judge, tribunal, court)\n * that made a prior decision in the case that is the subject of the document. Both\n * individual judges and courts should be annotated with this role where\n * applicable. This is not to be used for authorities cited as precedent, only for\n * those that made prior decisions in the same case. | | `prosecutor` | A lawyer\n * prosecuting the case that is the subject of the document. | | `defense_counsel`\n * | A lawyer defending the case that is the subject of the document. | | `amicus`\n * | A party filing an amicus curiae brief in the case that is the subject of the\n * document. | | `intervener` | A party attempting to or that has intervened in the\n * case that is the subject of the document. | | `borrower` | A party borrowing\n * money or other assets under the agreement that is the subject of the document,\n * including 'mortgagors' and 'debtors'. | | `lender` | A party lending money or\n * other assets under the agreement that is the subject of the document, including\n * 'mortgagees' and 'creditors'. | | `guarantor` | A party guaranteeing obligations\n * under the agreement that is the subject of the document, including 'sureties'. |\n * | `lessee` | A party leasing goods or services under the agreement that is the\n * subject of the document, including 'tenants'. | | `lessor` | A party leasing\n * goods or services under the agreement that is the subject of the document,\n * including 'landlords'. | | `employer` | A party employing personnel under the\n * agreement that is the subject of the document. | | `employee` | A party employed\n * under the agreement that is the subject of the document. | | `licensor` | A\n * party licensing intellectual property or other rights under the agreement that\n * are the subject of the document. | | `licensee` | A party licensed to use\n * intellectual property or other rights under the agreement that are the subject\n * of the document. | | `franchisor` | A party granting a franchise under the\n * agreement that is the subject of the document. | | `franchisee` | A party\n * granted a franchise under the agreement that is the subject of the document. | |\n * `buyer` | A party purchasing goods or services under the agreement that is the\n * subject of the document, including 'purchasers', 'customers', and 'clients'. | |\n * `seller` | A party selling or providing goods or services under the agreement\n * that is the subject of the document, including 'Vendors', 'Suppliers', and\n * 'Service Providers' (where such parties are actually providing goods or services\n * under the agreement). | | `contractor` | A party contracted to perform work or\n * services under the agreement that is the subject of the document, including\n * 'consultants'. | | `shareholder` | A party holding shares or equity under the\n * agreement that is the subject of the document. | | `joint_venturer` | A party\n * participating in a joint venture under the agreement that is the subject of the\n * document. | | `investor` | A party investing money or assets under the agreement\n * that is the subject of the document. | | `insurer` | A party providing insurance\n * under the agreement that is the subject of the document. | | `insured` | A party\n * insured under the agreement that is the subject of the document. | | `settlor` |\n * A party establishing the trust that is the subject of the document. | |\n * `trustee` | A party managing the trust that is the subject of the document. | |\n * `beneficiary` | A party benefiting from the trust that is the subject of the\n * document. | | `enacting_authority` | An authority (e.g., legislature, regulator,\n * Minister/Secretary, President/Prime Minister, tribunal, court, judge) giving\n * legal effect to or authorizing the document. All relevant individuals and bodies\n * should be annotated with this role where applicable. | | `empowered_authority` |\n * An authority (e.g., government agency, regulator, Minister/Secretary,\n * President/Prime Minister, tribunal, court) empowered by the document to carry\n * out functions or duties. | | `debater` | A person participating in the debate\n * that is the subject of the document. | | `governing_jurisdiction` | The\n * jurisdiction whose laws govern the document. | | `director` | A director or\n * other officer of a corporate legal person mentioned in the document. | | `clerk`\n * | A clerk, notary, or other official certifying, witnessing, filing, recording,\n * registering, or otherwise administering the document. | | `witness` | A witness\n * witnessing the signing of the document, or whose testimony is part of the case\n * that is the subject of the document. | | `other` | A party to the case,\n * agreement, legislation, or regulation that is the subject of the document that\n * does not fit into any of the other roles. | | `non_party` | A legal person\n * mentioned in the document that is not a party to the case, agreement,\n * legislation, or regulation that is the subject of the document. |\n */\n role:\n | \"plaintiff\"\n | \"petitioner\"\n | \"applicant\"\n | \"appellant\"\n | \"appellee\"\n | \"claimant\"\n | \"complainant\"\n | \"defendant\"\n | \"respondent\"\n | \"prior_authority\"\n | \"prosecutor\"\n | \"defense_counsel\"\n | \"amicus\"\n | \"intervener\"\n | \"borrower\"\n | \"lender\"\n | \"guarantor\"\n | \"lessee\"\n | \"lessor\"\n | \"employer\"\n | \"employee\"\n | \"licensor\"\n | \"licensee\"\n | \"franchisor\"\n | \"franchisee\"\n | \"buyer\"\n | \"seller\"\n | \"contractor\"\n | \"shareholder\"\n | \"joint_venturer\"\n | \"investor\"\n | \"insurer\"\n | \"insured\"\n | \"enacting_authority\"\n | \"empowered_authority\"\n | \"settlor\"\n | \"trustee\"\n | \"beneficiary\"\n | \"debater\"\n | \"director\"\n | \"governing_jurisdiction\"\n | \"clerk\"\n | \"witness\"\n | \"other\"\n | \"non_party\";\n\n /**\n * A unique identifier for a legal person in the format `per:{index}` where\n * `{index}` is a non-negative incrementing integer starting from zero.\n */\n parent: string | null;\n\n /**\n * The unique identifiers of any persons having this person as their immediate\n * parent.\n */\n children: Array;\n\n /**\n * A unique identifier for a location in the format `loc:{index}` where `{index}`\n * is a non-negative incrementing integer starting from zero.\n */\n residence: string | null;\n\n /**\n * An array of one or more spans within the document's text where the person is\n * mentioned.\n */\n mentions: Array;\n}\n\n/**\n * A valid phone number identified in a document belonging to a legal person.\n *\n * If a phone number was mentioned in the document but is not valid, possible, or\n * attributable to a legal person, it will not be extracted.\n */\nexport interface PhoneNumber {\n /**\n * The normalized phone number in E.123 international notation conforming with\n * local conventions on the use of spaces and hyphens as separators.\n */\n number: string;\n\n /**\n * The unique identifier of the person that this phone number belongs to.\n */\n person: string;\n\n /**\n * An array of one or more spans within the document's text where the phone number\n * is mentioned.\n */\n mentions: Array;\n}\n\n/**\n * A quotation within a document.\n */\nexport interface Quote {\n /**\n * A unique identifier for a segment in the format `seg:{index}` where `{index}` is\n * a non-negative incrementing integer starting from zero.\n */\n source_segment: string | null;\n\n /**\n * A unique identifier for an external document in the format `exd:{index}` where\n * `{index}` is a non-negative incrementing integer starting from zero.\n */\n source_document: string | null;\n\n /**\n * A unique identifier for a legal person in the format `per:{index}` where\n * `{index}` is a non-negative incrementing integer starting from zero.\n */\n source_person: string | null;\n\n /**\n * Whether the quote is being used to amend or modify content, typically in other\n * documents.\n */\n amending: boolean;\n\n /**\n * A zero-based, half-open span into the Unicode code point space of input text.\n *\n * All spans are globally laminar and well-nested similar to XML—it is impossible\n * for any two spans to partially overlap; they can only be disjoint, adjacent, or\n * wholly nested. Spans of the exact same type (e.g., segments) will never be\n * duplicated.\n *\n * A span cannot be empty and will never start or end at whitespace.\n *\n * Note that, when using programming languages other than Python (which uses\n * zero-based, half-open, Unicode code point-spaced string indexing), indices may\n * need to be translated accordingly (for example, JavaScript slices into UTF-16\n * code units instead of Unicode code points).\n */\n span: Span;\n}\n\n/**\n * A segment within the document representing a structurally distinct portion of\n * the document's content.\n */\nexport interface Segment {\n /**\n * The unique identifier of the segment in the format `seg:{index}` where `{index}`\n * is a non-negative incrementing integer starting from zero.\n */\n id: string;\n\n /**\n * The structural 'kind' of the segment, being one of `container`, `unit`, `item`,\n * or `figure`.\n *\n * A `container` is a structural or semantic grouping of content such as a chapter.\n * It can contain segments of any kind or none at all.\n *\n * A `unit` is a single syntactically independent unit of text such as a paragraph.\n * It can only contain `item`s and `figure`s.\n *\n * An `item` is a syntactically subordinate unit of text such as an item in a\n * run-in list. It can only contain other `item`s. Note that an `item` is\n * conceptually distinct from a list item—it is perfectly possible to encounter\n * list items that are syntactically independent of their surrounding items just as\n * it is possible to encounter dependent clauses that do not appear as part of a\n * list.\n *\n * A `figure` is a visually structured or tabular unit of content such as a\n * diagram, equation, or table. It cannot contain segments.\n */\n kind: \"container\" | \"unit\" | \"item\" | \"figure\";\n\n /**\n * The addressable 'type' of the segment within the document's referential scheme\n * and hierarchy, whether defined explicitly (e.g., by headings, such as\n * 'Section 2. Definitions'), implicitly (e.g., by way of reference, such as 'as\n * defined in Section 2'), or by convention (e.g., [42] in a judgment often denotes\n * a `paragraph`, independent provisions in statute are often `section`s, etc.). If\n * the type is not known or not applicable, it will be set to `null`.\n *\n * Note that, although many segment types may coincide with syntactic constructs,\n * they should be thought of purely as distinct formal citable units. Most\n * paragraphs (in the syntactic sense) will not have the `paragraph` type, for\n * example. That type is reserved for segments that would formally be cited as a\n * 'Paragraph' within the document's referential scheme.\n *\n * The following types are currently supported: `title`, `book`, `part`, `chapter`,\n * `subchapter`, `division`, `subdivision`, `subpart`, `subtitle`,\n * `table_of_contents`, `article`, `section`, `regulation`, `rule`, `clause`,\n * `paragraph`, `subarticle`, `subsection`, `subregulation`, `subrule`,\n * `subclause`, `subparagraph`, `item`, `subitem`, `point`, `indent`, `schedule`,\n * `annex`, `appendix`, `exhibit`, `recital`, `signature`, `note`, `figure`,\n * `table`, and `formula`.\n *\n * The `title`, `book`, `part`, `chapter`, `subchapter`, `division`, `subdivision`,\n * `subpart`, `subtitle`, and `table_of_contents` types are exclusive to the\n * `container` kind.\n *\n * The `figure` kind only supports the `figure`, `table`, and `formula` types, all\n * of which are exclusive to it.\n */\n type:\n | \"title\"\n | \"book\"\n | \"part\"\n | \"chapter\"\n | \"subchapter\"\n | \"division\"\n | \"subdivision\"\n | \"subpart\"\n | \"subtitle\"\n | \"table_of_contents\"\n | \"article\"\n | \"section\"\n | \"regulation\"\n | \"rule\"\n | \"clause\"\n | \"paragraph\"\n | \"subarticle\"\n | \"subsection\"\n | \"subregulation\"\n | \"subrule\"\n | \"subclause\"\n | \"subparagraph\"\n | \"item\"\n | \"subitem\"\n | \"point\"\n | \"indent\"\n | \"schedule\"\n | \"annex\"\n | \"appendix\"\n | \"exhibit\"\n | \"recital\"\n | \"signature\"\n | \"note\"\n | \"figure\"\n | \"table\"\n | \"formula\"\n | null;\n\n /**\n * The functional 'category' of the segment within the document, being one of\n * `front_matter`, `scope`, `main`, `annotation`, `back_matter`, or `other`.\n *\n * `front_matter` denotes non-operative contextualizing content occurring at the\n * start of a document such as a preamble or recitals.\n *\n * `scope` denotes operative content defining the application or interpretation of\n * a document such as definition sections and governing law clauses.\n *\n * `main` denotes operative, non-scopal content.\n *\n * `annotation` denotes non-operative annotative content providing explanatory or\n * referential information such as commentary, footnotes, and endnotes.\n *\n * `back_matter` denotes non-operative contextualizing content occurring at the end\n * of a document such as authority statements.\n *\n * `other` denotes content that does not fit into any of the other categories.\n */\n category:\n | \"front_matter\"\n | \"scope\"\n | \"main\"\n | \"annotation\"\n | \"back_matter\"\n | \"other\";\n\n /**\n * A zero-based, half-open span into the Unicode code point space of input text.\n *\n * All spans are globally laminar and well-nested similar to XML—it is impossible\n * for any two spans to partially overlap; they can only be disjoint, adjacent, or\n * wholly nested. Spans of the exact same type (e.g., segments) will never be\n * duplicated.\n *\n * A span cannot be empty and will never start or end at whitespace.\n *\n * Note that, when using programming languages other than Python (which uses\n * zero-based, half-open, Unicode code point-spaced string indexing), indices may\n * need to be translated accordingly (for example, JavaScript slices into UTF-16\n * code units instead of Unicode code points).\n */\n type_name: Span | null;\n\n /**\n * A zero-based, half-open span into the Unicode code point space of input text.\n *\n * All spans are globally laminar and well-nested similar to XML—it is impossible\n * for any two spans to partially overlap; they can only be disjoint, adjacent, or\n * wholly nested. Spans of the exact same type (e.g., segments) will never be\n * duplicated.\n *\n * A span cannot be empty and will never start or end at whitespace.\n *\n * Note that, when using programming languages other than Python (which uses\n * zero-based, half-open, Unicode code point-spaced string indexing), indices may\n * need to be translated accordingly (for example, JavaScript slices into UTF-16\n * code units instead of Unicode code points).\n */\n code: Span | null;\n\n /**\n * A zero-based, half-open span into the Unicode code point space of input text.\n *\n * All spans are globally laminar and well-nested similar to XML—it is impossible\n * for any two spans to partially overlap; they can only be disjoint, adjacent, or\n * wholly nested. Spans of the exact same type (e.g., segments) will never be\n * duplicated.\n *\n * A span cannot be empty and will never start or end at whitespace.\n *\n * Note that, when using programming languages other than Python (which uses\n * zero-based, half-open, Unicode code point-spaced string indexing), indices may\n * need to be translated accordingly (for example, JavaScript slices into UTF-16\n * code units instead of Unicode code points).\n */\n title: Span | null;\n\n /**\n * A unique identifier for a segment in the format `seg:{index}` where `{index}` is\n * a non-negative incrementing integer starting from zero.\n */\n parent: string | null;\n\n /**\n * The unique identifiers of any segments having this segment as their immediate\n * parent.\n */\n children: Array;\n\n /**\n * The level of the segment within the document's segment hierarchy starting from\n * `0` for root-level segments.\n */\n level: number;\n\n /**\n * A zero-based, half-open span into the Unicode code point space of input text.\n *\n * All spans are globally laminar and well-nested similar to XML—it is impossible\n * for any two spans to partially overlap; they can only be disjoint, adjacent, or\n * wholly nested. Spans of the exact same type (e.g., segments) will never be\n * duplicated.\n *\n * A span cannot be empty and will never start or end at whitespace.\n *\n * Note that, when using programming languages other than Python (which uses\n * zero-based, half-open, Unicode code point-spaced string indexing), indices may\n * need to be translated accordingly (for example, JavaScript slices into UTF-16\n * code units instead of Unicode code points).\n */\n span: Span;\n}\n\n/**\n * A zero-based, half-open span into the Unicode code point space of input text.\n *\n * All spans are globally laminar and well-nested similar to XML—it is impossible\n * for any two spans to partially overlap; they can only be disjoint, adjacent, or\n * wholly nested. Spans of the exact same type (e.g., segments) will never be\n * duplicated.\n *\n * A span cannot be empty and will never start or end at whitespace.\n *\n * Note that, when using programming languages other than Python (which uses\n * zero-based, half-open, Unicode code point-spaced string indexing), indices may\n * need to be translated accordingly (for example, JavaScript slices into UTF-16\n * code units instead of Unicode code points).\n */\nexport interface Span {\n /**\n * The zero-based start index of the half-open span of Unicode code points in the\n * input text.\n */\n start: number;\n\n /**\n * The zero-based end index of the half-open span (i.e., the end is exclusive) of\n * Unicode code points in the input text.\n */\n end: number;\n}\n\n/**\n * A term assigned a definite meaning within a document.\n */\nexport interface Term {\n /**\n * The unique identifier of the term in the format `term:{index}` where `{index}`\n * is a non-negative incrementing integer starting from zero.\n */\n id: string;\n\n /**\n * A zero-based, half-open span into the Unicode code point space of input text.\n *\n * All spans are globally laminar and well-nested similar to XML—it is impossible\n * for any two spans to partially overlap; they can only be disjoint, adjacent, or\n * wholly nested. Spans of the exact same type (e.g., segments) will never be\n * duplicated.\n *\n * A span cannot be empty and will never start or end at whitespace.\n *\n * Note that, when using programming languages other than Python (which uses\n * zero-based, half-open, Unicode code point-spaced string indexing), indices may\n * need to be translated accordingly (for example, JavaScript slices into UTF-16\n * code units instead of Unicode code points).\n */\n name: Span;\n\n /**\n * A zero-based, half-open span into the Unicode code point space of input text.\n *\n * All spans are globally laminar and well-nested similar to XML—it is impossible\n * for any two spans to partially overlap; they can only be disjoint, adjacent, or\n * wholly nested. Spans of the exact same type (e.g., segments) will never be\n * duplicated.\n *\n * A span cannot be empty and will never start or end at whitespace.\n *\n * Note that, when using programming languages other than Python (which uses\n * zero-based, half-open, Unicode code point-spaced string indexing), indices may\n * need to be translated accordingly (for example, JavaScript slices into UTF-16\n * code units instead of Unicode code points).\n */\n meaning: Span;\n\n /**\n * An array of spans within the document's text where the term is mentioned outside\n * of its definition.\n *\n * It is possible for the term to have no mentions if, outside of its definition,\n * it is never referred to in the document.\n */\n mentions: Array;\n}\n\n/**\n * A website identified in a document belonging to a legal person.\n *\n * If a website was mentioned in the document but is not attributable to a legal\n * person, it will not be extracted.\n */\nexport interface Website {\n /**\n * The normalized URL of the website in the form `https://{host}/`.\n */\n url: string;\n\n /**\n * The unique identifier of the person that this website belongs to.\n */\n person: string;\n\n /**\n * An array of one or more spans within the document's text where the website is\n * mentioned (including paths and slugs which are not part of the website's\n * normalized URL).\n */\n mentions: Array;\n}\n\nexport declare namespace v1 {\n export {\n type Crossreference as Crossreference,\n type Date as Date,\n type Document as Document,\n type Email as Email,\n type ExternalDocument as ExternalDocument,\n type IDNumber as IDNumber,\n type Location as Location,\n type Person as Person,\n type PhoneNumber as PhoneNumber,\n type Quote as Quote,\n type Segment as Segment,\n type Span as Span,\n type Term as Term,\n type Website as Website,\n };\n}",[141],"c951d892-05d1-11f1-a76e-42dde27851f2","enrichments.ts","16261d10-05d0-11f1-9f30-42dde27851f2",80,["D",1770653400892],6,"// deno-lint-ignore-file no-namespace\n// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.\n\nimport * as v1API from \"./ilgs_v1.ts\";\n\nexport interface EnrichmentResponse {\n /**\n * The enriched documents alongside, and in order of, their indices in the input\n * array of texts.\n */\n results: Array;\n\n /**\n * Statistics about the usage of resources in the process of enriching the input.\n */\n usage: EnrichmentResponse.Usage;\n}\n\nexport namespace EnrichmentResponse {\n /**\n * An enriched document alongside its index in the input array of texts.\n */\n export interface Result {\n /**\n * The index of this document in the input array of texts, starting at `0` (and,\n * therefore, ending at the number of inputs minus `1`).\n */\n index: number;\n\n /**\n * The document enriched into version 1.0.0 of the Isaacus Legal Graph Schema\n * (IGLS).\n *\n * All spans in an enriched document graph are indexed into the Unicode code point\n * space of a source document.\n *\n * The start and end indices of spans are zero-based (i.e., the first Unicode code\n * point in the document is at index 0) and half-open (i.e., the end index is\n * exclusive).\n *\n * All spans are globally laminar and well-nested similar to XML—it is impossible\n * for any two spans to partially overlap; they can only be disjoint, adjacent, or\n * wholly nested.\n *\n * Spans of the exact same type (e.g., segments) will never be duplicated.\n *\n * Spans cannot be empty and will never start or end at whitespace.\n *\n * When using programming languages other than Python (which uses zero-based,\n * half-open, Unicode code point-spaced string indexing), indices may need to be\n * translated accordingly (for example, JavaScript slices into UTF-16 code units\n * instead of Unicode code points).\n */\n document: v1API.Document;\n }\n\n /**\n * Statistics about the usage of resources in the process of enriching the input.\n */\n export interface Usage {\n /**\n * The total number of tokens inputted to the model.\n */\n input_tokens: number;\n }\n}\n\nexport interface EnrichmentCreateParams {\n /**\n * The ID of the [model](https://docs.isaacus.com/models#enrichment) to use for\n * enrichment.\n */\n model: \"kanon-2-enricher\";\n\n /**\n * A text or array of texts to be enriched, each containing at least one\n * non-whitespace character.\n *\n * No more than 8 texts can be enriched in a single request.\n */\n texts: Array | string;\n\n /**\n * The strategy for handling content exceeding the model's maximum input length.\n *\n * `auto` currently behaves the same as `drop_end`, dropping excess tokens from the\n * end of input. In the future, `auto` may implement more sophisticated strategies\n * such as chunking and context-aware stitching.\n *\n * `drop_end` drops tokens from the end of input exceeding the model's maximum\n * input length.\n *\n * `null`, which is the default setting, raises an error if the input exceeds the\n * model's maximum input length.\n */\n overflow_strategy?: \"auto\" | \"drop_end\" | null;\n}\n\nexport declare namespace Enrichments {\n export {\n type EnrichmentCreateParams as EnrichmentCreateParams,\n type EnrichmentResponse as EnrichmentResponse,\n };\n}",[149],"daabf5f2-06a6-11f1-814b-42dde27851f2","deno.json","daabf6a6-06a6-11f1-814b-42dde27851f2",92,["D",1770744912805],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/98f62cee78e85bfc47c62ed703777c6bc8794f1c/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": true,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"include\": [\"deno:/https/esm.town/**/*\"],\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}",[157],"dab87b42-06a6-11f1-b2cd-42dde27851f2","AGENTS.md","dab87c0a-06a6-11f1-b2cd-42dde27851f2",94,["D",1770744912852],"You are an advanced assistant specialized in generating Val Town code.\n\n## Core Guidelines\n\n- Ask clarifying questions when requirements are ambiguous\n- Provide complete, functional solutions rather than skeleton implementations\n- Test your logic against edge cases before presenting the final solution\n- Ensure all code follows Val Town's specific platform requirements\n- If a section of code that you're working on is getting too complex, consider refactoring it into subcomponents\n\n## Code Standards\n\n- Generate code in TypeScript or TSX\n- Add appropriate TypeScript types and interfaces for all data structures\n- Prefer official SDKs or libraries than writing API calls directly\n- Ask the user to supply API or library documentation if you are at all unsure about it\n- **Never bake in secrets into the code** - always use environment variables\n- Include comments explaining complex logic (avoid commenting obvious operations)\n- Follow modern ES6+ conventions and functional programming practices if possible\n\n## Types of triggers\n\n### 1. HTTP Trigger\n\n- Create web APIs and endpoints\n- Handle HTTP requests and responses\n- Example structure:\n\n```ts\nexport default async function (req: Request) {\n return new Response(\"Hello World\");\n}\n```\n\nFiles that are HTTP triggers have http in their name like `foobar.http.tsx`\n\n### 2. Cron Triggers\n\n- Run on a schedule\n- Use cron expressions for timing\n- Example structure:\n\n```ts\nexport default async function () {\n // Scheduled task code\n}\n```\n\nFiles that are Cron triggers have cron in their name like `foobar.cron.tsx`\n\n### 3. Email Triggers\n\n- Process incoming emails\n- Handle email-based workflows\n- Example structure:\n\n```ts\nexport default async function (email: Email) {\n // Process email\n}\n```\n\nFiles that are Email triggers have email in their name like `foobar.email.tsx`\n\n\n## Val Town Standard Libraries\n\nVal Town provides several hosted services and utility functions.\n\n### Blob Storage\n\n```ts\nimport { blob } from \"https://esm.town/v/std/blob\";\nawait blob.setJSON(\"myKey\", { hello: \"world\" });\nlet blobDemo = await blob.getJSON(\"myKey\");\nlet appKeys = await blob.list(\"app_\");\nawait blob.delete(\"myKey\");\n```\n\n### SQLite\n\n```ts\nimport { sqlite } from \"https://esm.town/v/stevekrouse/sqlite\";\nconst TABLE_NAME = 'todo_app_users_2';\n// Create table - do this before usage and change table name when modifying schema\nawait sqlite.execute(`CREATE TABLE IF NOT EXISTS ${TABLE_NAME} (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL\n)`);\n// Query data\nconst result = await sqlite.execute(`SELECT * FROM ${TABLE_NAME} WHERE id = ?`, [1]);\n```\n\nNote: When changing a SQLite table's schema, change the table's name (e.g., add _2 or _3) to create a fresh table.\n\n### OpenAI\n\n```ts\nimport { OpenAI } from \"https://esm.town/v/std/openai\";\nconst openai = new OpenAI();\nconst completion = await openai.chat.completions.create({\n messages: [\n { role: \"user\", content: \"Say hello in a creative way\" },\n ],\n model: \"gpt-4o-mini\",\n max_tokens: 30,\n});\n```\n\n### Email\n\n```ts\nimport { email } from \"https://esm.town/v/std/email\";\n// By default emails the owner of the val\nawait email({ \n subject: \"Hi\", \n text: \"Hi\", \n html: \"

Hi

\"\n});\n```\n\n## Val Town Utility Functions\n\nVal Town provides several utility functions to help with common project tasks.\n\n### Importing Utilities\n\nAlways import utilities with version pins to avoid breaking changes:\n\n```ts\nimport { parseProject, readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n```\n\n### Available Utilities\n\n\n#### **serveFile** - Serve project files with proper content types\n\nFor example, in Hono:\n\n```ts\n// serve all files in frontend/ and shared/\napp.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n```\n\n#### **readFile** - Read files from within the project:\n\n```ts\n// Read a file from the project\nconst fileContent = await readFile(\"/frontend/index.html\", import.meta.url);\n```\n\n#### **listFiles** - List all files in the project\n\n```ts\nconst files = await listFiles(import.meta.url);\n```\n\n#### **parseProject** - Extract information about the current project from import.meta.url\n\nThis is useful for including info for linking back to a val, ie in \"view source\" urls:\n\n```ts\nconst projectVal = parseProject(import.meta.url);\nconsole.log(projectVal.username); // Owner of the project\nconsole.log(projectVal.name); // Project name\nconsole.log(projectVal.version); // Version number\nconsole.log(projectVal.branch); // Branch name\nconsole.log(projectVal.links.self.project); // URL to the project page\n```\n\nHowever, it's *extremely importing* to note that `parseProject` and other Standard Library utilities ONLY RUN ON THE SERVER.\nIf you need access to this data on the client, run it in the server and pass it to the client by splicing it into the HTML page\nor by making an API request for it.\n\n## Val Town Platform Specifics\n\n- **Redirects:** Use `return new Response(null, { status: 302, headers: { Location: \"/place/to/redirect\" }})` instead of `Response.redirect` which is broken\n- **Images:** Avoid external images or base64 images. Use emojis, unicode symbols, or icon fonts/libraries instead\n- **AI Image:** To inline generate an AI image use: `

`\n- **Storage:** DO NOT use the Deno KV module for storage\n- **Browser APIs:** DO NOT use the `alert()`, `prompt()`, or `confirm()` methods\n- **Weather Data:** Use open-meteo for weather data (doesn't require API keys) unless otherwise specified\n- **View Source:** Add a view source link by importing & using `import.meta.url.replace(\"ems.sh\", \"val.town)\"` (or passing this data to the client) and include `target=\"_top\"` attribute\n- **Error Debugging:** Add `` to HTML to capture client-side errors\n- **Error Handling:** Only use try...catch when there's a clear local resolution; Avoid catches that merely log or return 500s. Let errors bubble up with full context\n- **Environment Variables:** Use `Deno.env.get('keyname')` when you need to, but generally prefer APIs that don't require keys\n- **Imports:** Use `https://esm.sh` for npm and Deno dependencies to ensure compatibility on server and browser\n- **Storage Strategy:** Only use backend storage if explicitly required; prefer simple static client-side sites\n- **React Configuration:** When using React libraries, pin versions with `?deps=react@18.2.0,react-dom@18.2.0` and start the file with `/** @jsxImportSource https://esm.sh/react@18.2.0 */`\n- Ensure all React dependencies and sub-dependencies are pinned to the same version\n- **Styling:** Default to using TailwindCSS via `` unless otherwise specified\n\n## Project Structure and Design Patterns\n\n### Recommended Directory Structure\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts # Schema definitions\n│ │ ├── queries.ts # DB query functions\n│ │ └── README.md\n│ └── routes/ # Route modules\n│ ├── [route].ts\n│ └── static.ts # Static file serving\n│ ├── index.ts # Main entry point\n│ └── README.md\n├── frontend/\n│ ├── components/\n│ │ ├── App.tsx\n│ │ └── [Component].tsx\n│ ├── favicon.svg\n│ ├── index.html # Main HTML template\n│ ├── index.tsx # Frontend JS entry point\n│ ├── README.md\n│ └── style.css\n├── README.md\n└── shared/\n ├── README.md\n └── utils.ts # Shared types and functions\n```\n\n### Backend (Hono) Best Practices\n\n- Hono is the recommended API framework\n- Main entry point should be `backend/index.ts`\n- **Static asset serving:** Use the utility functions to read and serve project files:\n ```ts\n import { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n \n // serve all files in frontend/ and shared/\n app.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\n app.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n \n // For index.html, often you'll want to bootstrap with initial data\n app.get(\"/\", async c => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n \n // Inject data to avoid extra round-trips\n const initialData = await fetchInitialData();\n const dataScript = ``;\n \n html = html.replace(\"\", `${dataScript}`);\n return c.html(html);\n });\n ```\n- Create RESTful API routes for CRUD operations\n- Always include this snippet at the top-level Hono app to re-throwing errors to see full stack traces:\n ```ts\n // Unwrap Hono errors to see original error details\n app.onError((err, c) => {\n throw err;\n });\n ```\n\n### Database Patterns\n- Run migrations on startup or comment out for performance\n- Change table names when modifying schemas rather than altering\n- Export clear query functions with proper TypeScript typing\n\n## Common Gotchas and Solutions\n\n1. **Environment Limitations:** \n - Val Town runs on Deno in a serverless context, not Node.js\n - Code in `shared/` must work in both frontend and backend environments\n - Cannot use `Deno` keyword in shared code\n - Use `https://esm.sh` for imports that work in both environments\n\n2. **SQLite Peculiarities:**\n - Limited support for ALTER TABLE operations\n - Create new tables with updated schemas and copy data when needed\n - Always run table creation before querying\n\n3. **React Configuration:**\n - All React dependencies must be pinned to 18.2.0\n - Always include `@jsxImportSource https://esm.sh/react@18.2.0` at the top of React files\n - Rendering issues often come from mismatched React versions\n\n4. **File Handling:**\n - Val Town only supports text files, not binary\n - Use the provided utilities to read files across branches and forks\n - For files in the project, use `readFile` helpers\n\n5. **API Design:**\n - `fetch` handler is the entry point for HTTP vals\n - Run the Hono app with `export default app.fetch // This is the entry point for HTTP vals`\n\n",[164],"dac794a6-06a6-11f1-b92a-42dde27851f2",".vtignore","dac79564-06a6-11f1-b92a-42dde27851f2",["D",1770744912859],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor",[171],"pulls","branches",1,"forks","envVars",{"_184":178,"_186":41},"connections",{"_184":41,"_185":41},"count","unfilledCount","emptyCount",{"_18":170,"_20":171,"_115":172,"_117":-5,"_118":67,"_119":65,"_121":37,"_22":213,"_64":41,"_124":95,"_126":174,"_128":26,"_129":-5,"_195":214,"_84":215},{"_18":163,"_20":164,"_115":165,"_117":-5,"_118":67,"_119":166,"_121":37,"_22":210,"_64":41,"_124":95,"_126":168,"_128":26,"_129":-5,"_195":211,"_84":212},{"_18":156,"_20":157,"_115":158,"_117":-5,"_118":67,"_119":159,"_121":37,"_22":207,"_64":41,"_124":95,"_126":161,"_128":26,"_129":-5,"_195":208,"_84":209},{"_18":148,"_20":149,"_115":150,"_117":-5,"_118":67,"_119":151,"_121":37,"_22":204,"_64":153,"_124":125,"_126":154,"_128":26,"_129":-5,"_195":205,"_84":206},{"_18":140,"_20":141,"_115":142,"_117":-5,"_118":67,"_119":143,"_121":37,"_22":201,"_64":145,"_124":125,"_126":146,"_128":26,"_129":-5,"_195":202,"_84":203},{"_18":131,"_20":132,"_115":35,"_117":-5,"_118":67,"_119":133,"_121":37,"_22":198,"_64":135,"_124":136,"_126":137,"_128":26,"_129":138,"_195":199,"_84":200},{"_18":113,"_20":114,"_115":116,"_117":-5,"_118":67,"_119":120,"_121":37,"_22":194,"_64":123,"_124":125,"_126":127,"_128":26,"_129":-5,"_195":196,"_84":197},["D",1770653429732],"children",[],[114],["D",1770744912849],[],[132],["D",1770653024106],[],[141],["D",1770653400892],[],[149],["D",1770744912805],[],[157],["D",1770744912852],[],[164],["D",1770744912859],[],[171],["D",1770604304187],{"_16":17,"_82":78},{"_16":17,"_76":-5,"_77":78,"_32":33,"_79":80,"_81":26},{"_64":65,"_20":66,"_18":67,"_68":19,"_69":-5,"_70":-5,"_71":-5,"_72":-5,"_73":-5,"_74":21,"_75":17},"ctx",{"_57":-5,"_103":253,"_254":255,"_256":257,"_258":26,"_259":26,"_260":26,"_261":37,"_262":-5,"_263":-7,"_264":-7,"_265":41,"_266":26,"_267":26,"_268":-5,"_269":26,"_270":26,"_271":26,"_272":-5},"ENV",{"_224":225,"_226":227,"_228":66,"_229":230,"_231":232,"_233":234,"_235":236,"_237":238,"_239":240,"_241":242,"_243":244,"_245":246,"_247":248,"_249":250,"_251":252},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Search