@qvac/harness 0.2.7 → 0.2.8

package/dist-lib/lib/tools/operations/builders.d.ts

@@ -12,6 +12,6 @@ export type BuilderOutcome = {
 export interface OperationBuilder {
     build: (args: Record<string, unknown>) => BuilderOutcome;
 }
-export declare const BUILDER_NAMES: readonly ["gmail-send", "gmail-draft", "calendar-meet-event", "calendar-add-meet", "docs-create", "docs-append-text", "sheets-create", "sheets-write-values", "sheets-append-values", "drive-create-folder", "drive-trash", "notion-create-page", "notion-insert-content"];
+export declare const BUILDER_NAMES: readonly ['gmail-send', 'gmail-draft', 'calendar-meet-event', 'calendar-add-meet', 'docs-create', 'docs-append-text', 'sheets-create', 'sheets-write-values', 'sheets-append-values', 'drive-create-folder', 'drive-trash', 'notion-create-page', 'notion-insert-content'];
 export type BuilderName = (typeof BUILDER_NAMES)[number];
 export declare const BUILDERS: Record<BuilderName, OperationBuilder>;

package/dist-lib/lib/tools/operations/builders.js

@@ -1,7 +1,7 @@
 import { randomBytes } from 'crypto';
 import b4a from 'b4a';
 import { z } from 'zod';
-import { buildGmailMessage, GmailEnvelopeSchema } from "./gmail-message.js";
+import { buildGmailMessage, GmailEnvelopeSchema } from './gmail-message.js';
 export const BUILDER_NAMES = [
     'gmail-send',
     'gmail-draft',

package/dist-lib/lib/tools/operations/compile.js

@@ -1,4 +1,4 @@
-import { BUILDERS } from "./builders.js";
+import { BUILDERS } from './builders.js';
 export function compileOperationTools(catalog, { httpRequestTool, mcpCallTool }) {
     return catalog.flatMap((entry) => (entry.operations ?? []).flatMap((operation) => {
         const transport = operation.request.transport === 'mcp' ? mcpCallTool : httpRequestTool;

package/dist-lib/lib/tools/operations/manifest.d.ts

@@ -9,46 +9,46 @@ declare const OperationSchema: z.ZodObject<{
         method: z.ZodString;
         url: z.ZodString;
         builder: z.ZodEnum<{
-            "gmail-send": "gmail-send";
-            "gmail-draft": "gmail-draft";
-            "calendar-meet-event": "calendar-meet-event";
             "calendar-add-meet": "calendar-add-meet";
-            "docs-create": "docs-create";
+            "calendar-meet-event": "calendar-meet-event";
             "docs-append-text": "docs-append-text";
-            "sheets-create": "sheets-create";
-            "sheets-write-values": "sheets-write-values";
-            "sheets-append-values": "sheets-append-values";
+            "docs-create": "docs-create";
             "drive-create-folder": "drive-create-folder";
             "drive-trash": "drive-trash";
+            "gmail-draft": "gmail-draft";
+            "gmail-send": "gmail-send";
             "notion-create-page": "notion-create-page";
             "notion-insert-content": "notion-insert-content";
+            "sheets-append-values": "sheets-append-values";
+            "sheets-create": "sheets-create";
+            "sheets-write-values": "sheets-write-values";
         }>;
     }, z.core.$strip>, z.ZodObject<{
         transport: z.ZodOptional<z.ZodLiteral<"http">>;
         method: z.ZodEnum<{
+            DELETE: "DELETE";
             GET: "GET";
+            PATCH: "PATCH";
             POST: "POST";
             PUT: "PUT";
-            PATCH: "PATCH";
-            DELETE: "DELETE";
         }>;
         url: z.ZodString;
         query: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
         urlDefaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         builder: z.ZodEnum<{
-            "gmail-send": "gmail-send";
-            "gmail-draft": "gmail-draft";
-            "calendar-meet-event": "calendar-meet-event";
             "calendar-add-meet": "calendar-add-meet";
-            "docs-create": "docs-create";
+            "calendar-meet-event": "calendar-meet-event";
             "docs-append-text": "docs-append-text";
-            "sheets-create": "sheets-create";
-            "sheets-write-values": "sheets-write-values";
-            "sheets-append-values": "sheets-append-values";
+            "docs-create": "docs-create";
             "drive-create-folder": "drive-create-folder";
             "drive-trash": "drive-trash";
+            "gmail-draft": "gmail-draft";
+            "gmail-send": "gmail-send";
             "notion-create-page": "notion-create-page";
             "notion-insert-content": "notion-insert-content";
+            "sheets-append-values": "sheets-append-values";
+            "sheets-create": "sheets-create";
+            "sheets-write-values": "sheets-write-values";
         }>;
     }, z.core.$strip>]>;
     response: z.ZodOptional<z.ZodObject<{

package/dist-lib/lib/tools/operations/manifest.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { BUILDER_NAMES } from "./builders.js";
+import { BUILDER_NAMES } from './builders.js';
 const ParameterType = z.enum(['string', 'number', 'boolean', 'object', 'integer', 'array', 'null']);
 const ParameterSchema = z.lazy(() => z.object({
     type: z.union([ParameterType, z.array(ParameterType).min(1)]),

package/dist-lib/lib/tools/outbound-guard.js

@@ -1,6 +1,6 @@
 import { grounded } from 'asenion';
 import { decodeBase64, printableRatio, strings } from 'asenion/guards';
-import { READ_METHODS } from "./http-methods.js";
+import { READ_METHODS } from './http-methods.js';
 const ADDRESS = /[^\s<>,;:"'\\]{1,64}@[^\s<>,;:"'\\]{1,255}\.[A-Za-z]{2,24}/g;
 const PRINTABLE_RATIO = 0.9;
 const RESERVED_DOMAINS = new Set(['example.com', 'example.net', 'example.org']);

package/dist-lib/lib/tools/rag-search.js

@@ -1,4 +1,4 @@
-import { RAG_CITATION_LINE } from "../prompt.js";
+import { RAG_CITATION_LINE } from '../prompt.js';
 const DEFAULT_LIMIT = 5;
 const MAX_LIMIT = 20;
 const EXCERPT_CHARS = 1200;

package/dist-lib/lib/tools/read-files.js

@@ -1,6 +1,6 @@
-import { readLines } from "./fs/read.js";
-import { isDriveReadTruncated } from "./fs/remote.js";
-import { canonicalDenyRoots, defaultRealpath, resolveKey } from "./fs/scope.js";
+import { readLines } from './fs/read.js';
+import { isDriveReadTruncated } from './fs/remote.js';
+import { canonicalDenyRoots, defaultRealpath, resolveKey } from './fs/scope.js';
 export const DEFAULT_READ_CHARS = 8192;
 export const MAX_READ_CHARS = 65_536;
 function lineIndex(value) {

package/dist-lib/lib/tools/skill.js

@@ -1,14 +1,14 @@
 import path from 'path';
 import b4a from 'b4a';
 import Localdrive from 'localdrive';
-import { OBSIDIAN_VAULT_MODE_NOTE } from "./exec/obsidian/guidance.js";
-import { unquoteArg } from "./model-args.js";
-import { credentialRecord } from "./skills/auth-resolver.js";
-import { resolveSkillsOverlayDir } from "./skills/overlay-dir.js";
-import { parseSkillFrontMatter } from "./skills/frontmatter-parser.js";
-import { parseToolGrant } from "./skills/tool-grants.js";
-import { shellEscapeArg } from "./exec/shell-argv.js";
-import { isObsidianVaultPath, OBSIDIAN_SKILL_NAME, OBSIDIAN_VAULT_PATH_CREDENTIAL_KEY } from "./skills/obsidian-readiness.js";
+import { OBSIDIAN_VAULT_MODE_NOTE } from './exec/obsidian/guidance.js';
+import { unquoteArg } from './model-args.js';
+import { credentialRecord } from './skills/auth-resolver.js';
+import { resolveSkillsOverlayDir } from './skills/overlay-dir.js';
+import { parseSkillFrontMatter } from './skills/frontmatter-parser.js';
+import { parseToolGrant } from './skills/tool-grants.js';
+import { shellEscapeArg } from './exec/shell-argv.js';
+import { isObsidianVaultPath, OBSIDIAN_SKILL_NAME, OBSIDIAN_VAULT_PATH_CREDENTIAL_KEY } from './skills/obsidian-readiness.js';
 const MAIN_FILE = 'SKILL.md';
 function resolveSkillDir(root, name) {
     if (!root)

package/dist-lib/lib/tools/skills/auth-resolver.js

@@ -1,5 +1,5 @@
-import { raceAbort } from "../../helpers/race-abort.js";
-import { parseObjectArg } from "../http-request/utils.js";
+import { raceAbort } from '../../helpers/race-abort.js';
+import { parseObjectArg } from '../http-request/utils.js';
 export function credentialRecord(value) {
     if (typeof value === 'string')
         return value ? { token: value } : null;

package/dist-lib/lib/tools/skills/bin-check.js

@@ -1,7 +1,7 @@
 import fs from 'fs';
 import path from 'path';
 import process from 'process';
-import { withHomebrewPath } from "../../helpers/spawn-path.js";
+import { withHomebrewPath } from '../../helpers/spawn-path.js';
 const SAFE_BIN_NAME = /^[A-Za-z0-9._-]+$/;
 function envPath() {
     return process.env.PATH ?? process.env.Path ?? '';

package/dist-lib/lib/tools/skills/bundled-dir.js

@@ -2,8 +2,8 @@ import fs from 'fs';
 import os from 'os';
 import path from 'path';
 import process from 'process';
-import { userTmpPath } from "../../tmp-path.js";
-import { hashBundledSkills } from "./bundled-hash.js";
+import { userTmpPath } from '../../tmp-path.js';
+import { hashBundledSkills } from './bundled-hash.js';
 import { SKILLS as BUNDLED_SKILLS } from '@qvac/skills/bundled';
 import { SKILLS_HASH as BUNDLED_SKILLS_HASH } from '@qvac/skills/hash';
 let inflight = null;

package/dist-lib/lib/tools/skills/catalog.js

@@ -1,16 +1,16 @@
 import fs from 'fs';
 import { platform } from 'os';
 import path from 'path';
-import { parseSkillFrontMatter } from "./frontmatter-parser.js";
-import { buildCliValidator, loadSkillCli } from "./cli-schema.js";
-import { isModelCompatible, isStub, isToolSupported, resolveSkillState, SKILL_STATE, supportsPlatform } from "./skill-state.js";
-import { validateCredentialChecks } from "./credential-check.js";
-import { OBSIDIAN_SKILL_NAME } from "./obsidian-readiness.js";
-import { parseToolGrant } from "./tool-grants.js";
-import { deriveSetup } from "./setup-routes.js";
-import { resolveSkillsOverlayDir } from "./overlay-dir.js";
-import { parseOperationsManifest } from "../operations/manifest.js";
-import { hlog } from "../../log.js";
+import { parseSkillFrontMatter } from './frontmatter-parser.js';
+import { buildCliValidator, loadSkillCli } from './cli-schema.js';
+import { isModelCompatible, isStub, isToolSupported, resolveSkillState, SKILL_STATE, supportsPlatform } from './skill-state.js';
+import { validateCredentialChecks } from './credential-check.js';
+import { OBSIDIAN_SKILL_NAME } from './obsidian-readiness.js';
+import { parseToolGrant } from './tool-grants.js';
+import { deriveSetup } from './setup-routes.js';
+import { resolveSkillsOverlayDir } from './overlay-dir.js';
+import { parseOperationsManifest } from '../operations/manifest.js';
+import { hlog } from '../../log.js';
 export function skillSupportsPlatform(entry, platform) {
     return supportsPlatform(entry, platform);
 }

package/dist-lib/lib/tools/skills/cli-schema-check.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { argvToObject, isObjectSchema, objectProps, walkCommands } from "./cli-argv.js";
+import { argvToObject, isObjectSchema, objectProps, walkCommands } from './cli-argv.js';
 export function buildSchemaAnnotation(schema) {
     const resourceEffects = schema['x-resource-effects'];
     return (argv) => {

package/dist-lib/lib/tools/skills/cli-schema-load.js

@@ -1,6 +1,6 @@
 import fs from 'fs';
 import path from 'path';
-import { CLI_SCHEMA_FILENAME } from "./cli-schema-types.js";
+import { CLI_SCHEMA_FILENAME } from './cli-schema-types.js';
 export async function resolveCliSchema(skillDir, bin, readFile = (p) => fs.promises.readFile(p, 'utf8')) {
     const full = path.join(skillDir, CLI_SCHEMA_FILENAME);
     let raw;

package/dist-lib/lib/tools/skills/cli-schema.js

@@ -1,7 +1,7 @@
-export { CLI_SCHEMA_FILENAME } from "./cli-schema-types.js";
-export { argvToObject } from "./cli-argv.js";
-export { loadSkillCli, resolveCliSchema, execBinFromTools } from "./cli-schema-load.js";
-import { buildSchemaAnnotation, buildSchemaCheck } from "./cli-schema-check.js";
+export { CLI_SCHEMA_FILENAME } from './cli-schema-types.js';
+export { argvToObject } from './cli-argv.js';
+export { loadSkillCli, resolveCliSchema, execBinFromTools } from './cli-schema-load.js';
+import { buildSchemaAnnotation, buildSchemaCheck } from './cli-schema-check.js';
 export function buildCliValidator(def) {
     const bin = def.bin.toLowerCase();
     if (!def.schema) {

package/dist-lib/lib/tools/skills/credential-check.js

@@ -1,9 +1,9 @@
 import fetch from '#fetch';
 import { Headers } from '#headers';
 import { AbortController } from 'bare-abort-controller';
-import { DEFAULT_USER_AGENT } from "../../user-agent.js";
-import { credentialRecord, isCredentialUrlAllowed } from "./auth-resolver.js";
-import { credentialLastProbedAt, markCredentialRejected, markCredentialValid, setCredentialLastProbedAt } from "./credential-health.js";
+import { DEFAULT_USER_AGENT } from '../../user-agent.js';
+import { credentialRecord, isCredentialUrlAllowed } from './auth-resolver.js';
+import { credentialLastProbedAt, markCredentialRejected, markCredentialValid, setCredentialLastProbedAt } from './credential-health.js';
 const TIMEOUT_MS = 5_000;
 export const CREDENTIAL_CHECK_TTL_MS = 45_000;
 const inflight = new Map();

package/dist-lib/lib/tools/skills/credential-grants.js

@@ -1,4 +1,4 @@
-import { credentialSlots } from "./credential-slots.js";
+import { credentialSlots } from './credential-slots.js';
 export function credentialGrants(catalog, skills) {
     if (!skills || skills.length === 0)
         return {};

package/dist-lib/lib/tools/skills/credential-health.js

@@ -1,5 +1,5 @@
-import { hlog } from "../../log.js";
-import { scopeKey } from "./scope-key.js";
+import { hlog } from '../../log.js';
+import { scopeKey } from './scope-key.js';
 const rejected = new Set();
 const lastProbedAt = new Map();
 function scopedKey(key, agentId, skill) {

package/dist-lib/lib/tools/skills/frontmatter-parser.js

@@ -1,4 +1,4 @@
-import { parseManifestBlock } from "./manifest-parse.js";
+import { parseManifestBlock } from './manifest-parse.js';
 const FRONT_MATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
 const FIELD_RE = /^([A-Za-z_][\w-]*):(.*)$/;
 const LIST_FIELDS = new Set(['tools', 'platform', 'credentials', 'allow_list', 'aliases']);

package/dist-lib/lib/tools/skills/index.js

@@ -1,5 +1,5 @@
-export * from "./auth-resolver.js";
-export * from "./catalog.js";
-export * from "./cli-schema.js";
-export * from "./credential-grants.js";
-export * from "./frontmatter-parser.js";
+export * from './auth-resolver.js';
+export * from './catalog.js';
+export * from './cli-schema.js';
+export * from './credential-grants.js';
+export * from './frontmatter-parser.js';

package/dist-lib/lib/tools/skills/mention.js

@@ -1,5 +1,5 @@
 import { has } from 'asenion';
-import { skillMentionName } from "./mention-name.js";
+import { skillMentionName } from './mention-name.js';
 export { skillMentionName };
 export function resolveSkillMention(text, catalog) {
     const name = skillMentionName(text);

package/dist-lib/lib/tools/skills/overlay-crud.js

@@ -1,6 +1,6 @@
 import fs from 'fs';
 import path from 'path';
-import { randomSuffix } from "./bundled-dir.js";
+import { randomSuffix } from './bundled-dir.js';
 const SAFE_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
 function assertSafeName(name) {
     if (!SAFE_NAME.test(name)) {

package/dist-lib/lib/tools/skills/setup-routes.js

@@ -1,4 +1,4 @@
-import { SKILL_STATE } from "./skill-state.js";
+import { SKILL_STATE } from './skill-state.js';
 export function deriveSetup(entry, state) {
     if (!entry.setup)
         return undefined;

package/dist-lib/lib/tools/skills/skill-settings.js

@@ -1,4 +1,4 @@
-import { scopeKey } from "./scope-key.js";
+import { scopeKey } from './scope-key.js';
 function setupFields(entry) {
     return (entry.setup?.routes ?? []).flatMap((route) => route.fields ?? []);
 }

package/dist-lib/lib/tools/skills/skill-state-constants.d.ts

@@ -1,12 +1,12 @@
 export declare const SKILL_STATE: {
-    readonly ready: "ready";
-    readonly needsSetup: "needs-setup";
-    readonly disconnected: "disconnected";
-    readonly unsupported: "unsupported";
-    readonly disabled: "disabled";
-    readonly outdated: "outdated";
-    readonly incompatibleModel: "incompatible-model";
-    readonly failed: "failed";
+    readonly ready: 'ready';
+    readonly needsSetup: 'needs-setup';
+    readonly disconnected: 'disconnected';
+    readonly unsupported: 'unsupported';
+    readonly disabled: 'disabled';
+    readonly outdated: 'outdated';
+    readonly incompatibleModel: 'incompatible-model';
+    readonly failed: 'failed';
 };
 export type SkillState = (typeof SKILL_STATE)[keyof typeof SKILL_STATE];
 export declare function isAvailableState(state: SkillState): boolean;

package/dist-lib/lib/tools/skills/skill-state.js

@@ -1,12 +1,12 @@
-import { credentialRecord, isCredentialExpired } from "./auth-resolver.js";
-import { parseToolGrant } from "./tool-grants.js";
-import { missingBins } from "./bin-check.js";
-import { credentialSlots } from "./credential-slots.js";
-import { requiredSettings } from "./skill-settings.js";
-import { isCredentialRejected } from "./credential-health.js";
-import { isObsidianVaultPath, isSandboxedWorkbenchInstall, OBSIDIAN_SKILL_NAME, OBSIDIAN_VAULT_PATH_CREDENTIAL_KEY, obsidianCliState, obsidianInstallState } from "./obsidian-readiness.js";
-import { isCapabilityProfile, meetsMinCapabilityProfile } from "../../models/model-catalog.js";
-import { SKILL_STATE, isAvailableState } from "./skill-state-constants.js";
+import { credentialRecord, isCredentialExpired } from './auth-resolver.js';
+import { parseToolGrant } from './tool-grants.js';
+import { missingBins } from './bin-check.js';
+import { credentialSlots } from './credential-slots.js';
+import { requiredSettings } from './skill-settings.js';
+import { isCredentialRejected } from './credential-health.js';
+import { isObsidianVaultPath, isSandboxedWorkbenchInstall, OBSIDIAN_SKILL_NAME, OBSIDIAN_VAULT_PATH_CREDENTIAL_KEY, obsidianCliState, obsidianInstallState } from './obsidian-readiness.js';
+import { isCapabilityProfile, meetsMinCapabilityProfile } from '../../models/model-catalog.js';
+import { SKILL_STATE, isAvailableState } from './skill-state-constants.js';
 export { SKILL_STATE, isAvailableState };
 export function isStub(entry) {
     return entry.stub === true;

package/dist-lib/lib/tools/toolsets.d.ts

@@ -1,4 +1,4 @@
-export declare const TOOLSETS: readonly ["web-search", "knowledge", "files", "exec", "http-request", "mcp-call"];
+export declare const TOOLSETS: readonly ['web-search', 'knowledge', 'files', 'exec', 'http-request', 'mcp-call'];
 export type Toolset = (typeof TOOLSETS)[number];
 export declare function asToolset(value?: string | null): Toolset | null;
 export interface ToolsetScoped {

package/dist-lib/lib/tools/url-guard.js

@@ -1,5 +1,5 @@
-import { AbortedError, raceAbort } from "../helpers/race-abort.js";
-import { isPrivateOrBlocked, stripIPv6Brackets } from "./private-ip.js";
+import { AbortedError, raceAbort } from '../helpers/race-abort.js';
+import { isPrivateOrBlocked, stripIPv6Brackets } from './private-ip.js';
 const LITERAL_IPV4 = /^\d{1,3}(\.\d{1,3}){3}$/;
 export function checkOutboundHost(url) {
     const host = stripIPv6Brackets(url.hostname);

package/dist-lib/lib/tools/weather-lookup/place.d.ts

@@ -0,0 +1,11 @@
+export interface ResolvedPlace {
+    readonly area: string;
+    readonly region: string;
+    readonly country: string;
+}
+export declare function fold(value: string): string;
+export declare function describePlace(place: ResolvedPlace): string;
+export declare function qualifierOf(location: string): string | null;
+export declare function cityMatches(location: string, place: ResolvedPlace): boolean;
+export type QualifierVerdict = 'match' | 'unverifiable' | 'contradiction';
+export declare function checkQualifier(qualifier: string, place: ResolvedPlace): QualifierVerdict;

package/dist-lib/lib/tools/weather-lookup/place.js

@@ -0,0 +1,152 @@
+const QUALIFIER_ALIASES = [
+    ['united states of america', 'united states of america'],
+    ['united states', 'united states of america'],
+    ['u.s.a.', 'united states of america'],
+    ['u.s.', 'united states of america'],
+    ['usa', 'united states of america'],
+    ['us', 'united states of america'],
+    ['united kingdom', 'united kingdom'],
+    ['great britain', 'united kingdom'],
+    ['england', 'united kingdom'],
+    ['scotland', 'united kingdom'],
+    ['wales', 'united kingdom'],
+    ['northern ireland', 'united kingdom'],
+    ['u.k.', 'united kingdom'],
+    ['uk', 'united kingdom'],
+    ['gb', 'united kingdom'],
+    ['united arab emirates', 'united arab emirates'],
+    ['uae', 'united arab emirates'],
+    ['holland', 'netherlands'],
+    ['deutschland', 'germany'],
+    ['espana', 'spain'],
+    ['italia', 'italy']
+];
+const OTHER_SUBDIVISIONS = {
+    ab: 'alberta',
+    bc: 'british columbia',
+    mb: 'manitoba',
+    nb: 'new brunswick',
+    nl: 'newfoundland',
+    ns: 'nova scotia',
+    on: 'ontario',
+    pe: 'prince edward island',
+    qc: 'quebec',
+    sk: 'saskatchewan',
+    nsw: 'new south wales',
+    vic: 'victoria',
+    qld: 'queensland',
+    wa: 'western australia',
+    sa: 'south australia',
+    tas: 'tasmania',
+    nt: 'northern territory',
+    act: 'australian capital territory'
+};
+const US_STATES = {
+    al: 'alabama',
+    ak: 'alaska',
+    az: 'arizona',
+    ar: 'arkansas',
+    ca: 'california',
+    co: 'colorado',
+    ct: 'connecticut',
+    de: 'delaware',
+    fl: 'florida',
+    ga: 'georgia',
+    hi: 'hawaii',
+    id: 'idaho',
+    il: 'illinois',
+    in: 'indiana',
+    ia: 'iowa',
+    ks: 'kansas',
+    ky: 'kentucky',
+    la: 'louisiana',
+    me: 'maine',
+    md: 'maryland',
+    ma: 'massachusetts',
+    mi: 'michigan',
+    mn: 'minnesota',
+    ms: 'mississippi',
+    mo: 'missouri',
+    mt: 'montana',
+    ne: 'nebraska',
+    nv: 'nevada',
+    nh: 'new hampshire',
+    nj: 'new jersey',
+    nm: 'new mexico',
+    ny: 'new york',
+    nc: 'north carolina',
+    nd: 'north dakota',
+    oh: 'ohio',
+    ok: 'oklahoma',
+    or: 'oregon',
+    pa: 'pennsylvania',
+    ri: 'rhode island',
+    sc: 'south carolina',
+    sd: 'south dakota',
+    tn: 'tennessee',
+    tx: 'texas',
+    ut: 'utah',
+    vt: 'vermont',
+    va: 'virginia',
+    wa: 'washington',
+    wv: 'west virginia',
+    wi: 'wisconsin',
+    wy: 'wyoming',
+    dc: 'district of columbia'
+};
+export function fold(value) {
+    return value
+        .normalize('NFD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, ' ')
+        .trim();
+}
+export function describePlace(place) {
+    return [place.area, place.region, place.country].filter((part) => part.length > 0).join(', ');
+}
+export function qualifierOf(location) {
+    const comma = location.indexOf(',');
+    if (comma === -1)
+        return null;
+    const qualifier = fold(location.slice(comma + 1));
+    return qualifier.length > 0 ? qualifier : null;
+}
+function expand(qualifier) {
+    const code = qualifier.replace(/ /g, '');
+    const subdivision = US_STATES[code] ?? OTHER_SUBDIVISIONS[code];
+    if (subdivision !== undefined)
+        return subdivision;
+    for (const [alias, full] of QUALIFIER_ALIASES) {
+        if (qualifier === fold(alias))
+            return full;
+    }
+    return qualifier;
+}
+function initialsOf(name) {
+    return name
+        .split(' ')
+        .map((word) => word[0] ?? '')
+        .join('');
+}
+const ABBREVIATION = /^[a-z]{1,3}$/;
+export function cityMatches(location, place) {
+    const city = fold(location.split(',')[0] ?? '');
+    return city.length > 0 && fold(describePlace(place)).includes(city);
+}
+export function checkQualifier(qualifier, place) {
+    const wanted = expand(qualifier);
+    const code = qualifier.replace(/ /g, '');
+    const opaque = wanted === qualifier && ABBREVIATION.test(code);
+    for (const candidate of [fold(place.region), fold(place.country)]) {
+        if (candidate.length === 0)
+            continue;
+        if (initialsOf(candidate) === code)
+            return 'match';
+        if (opaque)
+            continue;
+        if (candidate.includes(wanted) || wanted.includes(candidate))
+            return 'match';
+    }
+    return opaque ? 'unverifiable' : 'contradiction';
+}

package/dist-lib/lib/tools/weather-lookup/report.d.ts

@@ -0,0 +1,37 @@
+import { type ResolvedPlace } from './place.ts';
+interface Translated {
+    readonly value: string;
+}
+interface CurrentCondition {
+    readonly temp_C?: string;
+    readonly temp_F?: string;
+    readonly FeelsLikeC?: string;
+    readonly humidity?: string;
+    readonly windspeedKmph?: string;
+    readonly weatherDesc?: ReadonlyArray<Translated>;
+}
+interface HourlyEntry {
+    readonly time?: string;
+    readonly weatherDesc?: ReadonlyArray<Translated>;
+}
+interface DailyForecast {
+    readonly date?: string;
+    readonly maxtempC?: string;
+    readonly mintempC?: string;
+    readonly maxtempF?: string;
+    readonly mintempF?: string;
+    readonly hourly?: ReadonlyArray<HourlyEntry>;
+}
+interface NearestArea {
+    readonly areaName?: ReadonlyArray<Translated>;
+    readonly region?: ReadonlyArray<Translated>;
+    readonly country?: ReadonlyArray<Translated>;
+}
+export interface WeatherJson {
+    readonly nearest_area?: ReadonlyArray<NearestArea>;
+    readonly current_condition?: ReadonlyArray<CurrentCondition>;
+    readonly weather?: ReadonlyArray<DailyForecast>;
+}
+export declare function placeOf(json: WeatherJson): ResolvedPlace | null;
+export declare function renderReport(json: WeatherJson, place: ResolvedPlace, asked: string, verified: boolean): string;
+export {};