@riverintel/stayfinder-plugin 0.2.0

package/dist/credential-store.js

@@ -0,0 +1,143 @@
+/**
+ * On-disk credential store for the StayFinder plugin.
+ *
+ * The plugin writes a single JSON file at ~/.openclaw/credentials/stayfinder.json
+ * (mode 0600 — readable only by the user) containing the API token and
+ * the small amount of metadata the plugin needs to drive re-auth without
+ * re-prompting the user for their email.
+ *
+ * The credential file shape is documented in types.ts (CredentialFile)
+ * and matches what stayfinder_verify writes after a successful exchange.
+ *
+ * Why a file (and not OpenClaw's credential API):
+ *   The plugin manifest's `credentialPath` field is a READ-time hint, not
+ *   a write API. There's no documented runtime API for plugins to write
+ *   their own credentials back through OpenClaw. Owning the file directly
+ *   at the documented path is the simplest forward-compatible answer:
+ *   if a write API ever lands, we switch to it; until then, the file
+ *   format we control is the contract.
+ *
+ * Read pattern:
+ *   - search-stays.ts reads the file on every call (no in-process cache)
+ *     so a fresh stayfinder_verify takes effect immediately
+ *   - The file is small (~200 bytes) and the read is local; the cost
+ *     is irrelevant
+ *
+ * Write pattern:
+ *   - stayfinder-verify.ts writes the file once after a successful
+ *     /v1/signup/verify response
+ *   - Atomic write via "write to temp + rename" so a crash mid-write
+ *     can't leave a half-written file the next read would choke on
+ *   - mode 0600 enforced explicitly (Node's default umask honors this
+ *     but we set it again at write time as defense in depth)
+ */
+import { existsSync, mkdirSync } from 'node:fs';
+import { chmod, readFile, rename, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Path resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the credential file path.
+ *
+ * Honors the OPENCLAW_HOME environment variable if set (used by OpenClaw's
+ * test/dev profiles to isolate state). Falls back to ~/.openclaw.
+ *
+ * The credentials/ subdirectory and the file itself are created on demand
+ * by writeCredential. They're never assumed to exist at read time.
+ */
+export function resolveCredentialPath(env = process.env) {
+    const home = env.OPENCLAW_HOME ?? join(homedir(), '.openclaw');
+    return join(home, 'credentials', 'stayfinder.json');
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Read the credential file. Returns null if it doesn't exist or if its
+ * contents don't parse as the expected shape.
+ *
+ * Critically: a missing or unreadable file returns null, NOT an error.
+ * "No credentials" is a normal state — the search_stays tool uses it as
+ * the trigger to surface `unauthorized` and walk the user through setup.
+ *
+ * We DO throw on a permission denied or other unexpected I/O error,
+ * because that's an environmental problem the user needs to know about
+ * and "silently treat as no creds" would be wrong (we'd loop them
+ * through signup forever without ever fixing the underlying issue).
+ */
+export async function readCredential(env = process.env) {
+    const path = resolveCredentialPath(env);
+    let raw;
+    try {
+        raw = await readFile(path, { encoding: 'utf-8' });
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return null;
+        throw new Error(`Failed to read credential file at ${path}: ${err.message}. ` +
+            'Check file permissions and re-run signup if needed.');
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        // Corrupt file — return null and let the user re-run signup. We
+        // don't try to recover; a malformed credentials file is rare and
+        // signup is cheap.
+        return null;
+    }
+    if (!isValidCredentialFile(parsed))
+        return null;
+    return parsed;
+}
+/**
+ * Write the credential file atomically with mode 0600.
+ *
+ * Creates the credentials/ directory (mode 0700) if it doesn't exist.
+ * Writes to a temp file in the same directory, sets permissions, then
+ * renames into place — so a crash mid-write leaves either the old file
+ * untouched or the new file complete, never a half-written file.
+ *
+ * Throws on any I/O failure. The signup_verify tool catches it and
+ * surfaces a clean error to the model.
+ */
+export async function writeCredential(credential, env = process.env) {
+    const path = resolveCredentialPath(env);
+    const dir = dirname(path);
+    // Create directory with 0700 (rwx user only) if missing.
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    const tempPath = `${path}.tmp.${process.pid}`;
+    const body = JSON.stringify(credential, null, 2) + '\n';
+    await writeFile(tempPath, body, { mode: 0o600, encoding: 'utf-8' });
+    // Re-chmod defensively in case the file already existed with looser perms.
+    await chmod(tempPath, 0o600);
+    await rename(tempPath, path);
+}
+// ---------------------------------------------------------------------------
+// Validation helpers
+// ---------------------------------------------------------------------------
+/**
+ * Type guard for CredentialFile. Used by readCredential to reject malformed
+ * files. We check every required field; an old file from a previous version
+ * of the plugin that lacks newer fields will be rejected and the user will
+ * re-run signup. That's the right tradeoff: re-signup is cheap (one paste)
+ * and silently accepting partial data risks weird state.
+ */
+function isValidCredentialFile(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    return (typeof v.api_token === 'string' &&
+        v.api_token.length > 0 &&
+        typeof v.saved_at === 'string' &&
+        typeof v.tenant_id === 'string' &&
+        typeof v.email === 'string' &&
+        (v.token_kind === 'ephemeral' || v.token_kind === 'persistent') &&
+        (v.expires_at === null || typeof v.expires_at === 'string'));
+}
+//# sourceMappingURL=credential-store.js.map

package/dist/credential-store.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Adapter error mapping.
+ *
+ * The plugin's three tools all talk to the StayFinder service, which
+ * returns a structured error envelope (see types.ts AdapterErrorEnvelope)
+ * for any non-2xx response. We translate that envelope into:
+ *
+ *   1. An `AdapterError` exception that the tool's `execute` function
+ *      throws — the OpenClaw runtime catches the throw and surfaces it
+ *      as a tool error to the model.
+ *
+ *   2. A short, model-facing message string that explains what happened
+ *      in plain English with an actionable next step. Models react much
+ *      better to "your access expired — call stayfinder_signup with the
+ *      cached email" than to "HTTP 401 token_expired".
+ *
+ * The message text is the most important thing in the file. It's what
+ * the agent reads when deciding what to tell the user, and it's where
+ * we encode the recovery flows for `unauthorized` / `token_expired` /
+ * `code_attempts_exceeded` etc.
+ */
+import type { AdapterErrorEnvelope } from './types.js';
+/**
+ * Thrown by adapter-client.ts when the StayFinder service returns a non-2xx
+ * response. The constructor pulls fields out of the standard error envelope.
+ *
+ * Tool `execute` functions catch this, format the message, and re-throw a
+ * new Error with the formatted text — the OpenClaw runtime then surfaces
+ * the throw to the model. The structured fields stay accessible via the
+ * `code`, `retryAfterSeconds`, etc. properties for tools that need to
+ * branch on them (e.g., search-stays.ts treats `token_expired` differently
+ * from `unauthorized`).
+ */
+export declare class AdapterError extends Error {
+    readonly code: string;
+    readonly httpStatus: number;
+    readonly retryAfterSeconds?: number;
+    readonly attemptsRemaining?: number;
+    readonly expiresAt?: string | null;
+    readonly requestId?: string;
+    readonly traceId?: string;
+    readonly details?: Record<string, unknown>;
+    constructor(envelope: AdapterErrorEnvelope, httpStatus: number);
+}
+/**
+ * Format an AdapterError as a single-string message the model can read.
+ *
+ * Each branch is hand-tuned for what the agent should DO with the error,
+ * not just what went wrong. We tell the model the next concrete action
+ * ("call stayfinder_signup with the cached email", "ask the user for a
+ * different email", "wait N minutes and retry") rather than leaving it
+ * to figure out the recovery flow on its own.
+ */
+export declare function formatErrorForModel(err: AdapterError): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMvD;;;;;;;;;;GAUG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE/B,QAAQ,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM;CAY/D;AAWD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAuI7D"}

package/dist/errors.js

@@ -0,0 +1,160 @@
+/**
+ * Adapter error mapping.
+ *
+ * The plugin's three tools all talk to the StayFinder service, which
+ * returns a structured error envelope (see types.ts AdapterErrorEnvelope)
+ * for any non-2xx response. We translate that envelope into:
+ *
+ *   1. An `AdapterError` exception that the tool's `execute` function
+ *      throws — the OpenClaw runtime catches the throw and surfaces it
+ *      as a tool error to the model.
+ *
+ *   2. A short, model-facing message string that explains what happened
+ *      in plain English with an actionable next step. Models react much
+ *      better to "your access expired — call stayfinder_signup with the
+ *      cached email" than to "HTTP 401 token_expired".
+ *
+ * The message text is the most important thing in the file. It's what
+ * the agent reads when deciding what to tell the user, and it's where
+ * we encode the recovery flows for `unauthorized` / `token_expired` /
+ * `code_attempts_exceeded` etc.
+ */
+// ---------------------------------------------------------------------------
+// Exception class
+// ---------------------------------------------------------------------------
+/**
+ * Thrown by adapter-client.ts when the StayFinder service returns a non-2xx
+ * response. The constructor pulls fields out of the standard error envelope.
+ *
+ * Tool `execute` functions catch this, format the message, and re-throw a
+ * new Error with the formatted text — the OpenClaw runtime then surfaces
+ * the throw to the model. The structured fields stay accessible via the
+ * `code`, `retryAfterSeconds`, etc. properties for tools that need to
+ * branch on them (e.g., search-stays.ts treats `token_expired` differently
+ * from `unauthorized`).
+ */
+export class AdapterError extends Error {
+    code;
+    httpStatus;
+    retryAfterSeconds;
+    attemptsRemaining;
+    expiresAt;
+    requestId;
+    traceId;
+    details;
+    constructor(envelope, httpStatus) {
+        super(envelope.error.message);
+        this.name = 'AdapterError';
+        this.code = envelope.error.code;
+        this.httpStatus = httpStatus;
+        this.retryAfterSeconds = envelope.error.retry_after_seconds;
+        this.attemptsRemaining = envelope.error.attempts_remaining;
+        this.expiresAt = envelope.error.expires_at ?? null;
+        this.requestId = envelope.error.request_id;
+        this.traceId = envelope.error.trace_id;
+        this.details = envelope.error.details;
+    }
+}
+// ---------------------------------------------------------------------------
+// Model-facing message formatting
+// ---------------------------------------------------------------------------
+const minutesFromSeconds = (s) => {
+    if (s === undefined || !Number.isFinite(s) || s <= 0)
+        return 1;
+    return Math.max(1, Math.ceil(s / 60));
+};
+/**
+ * Format an AdapterError as a single-string message the model can read.
+ *
+ * Each branch is hand-tuned for what the agent should DO with the error,
+ * not just what went wrong. We tell the model the next concrete action
+ * ("call stayfinder_signup with the cached email", "ask the user for a
+ * different email", "wait N minutes and retry") rather than leaving it
+ * to figure out the recovery flow on its own.
+ */
+export function formatErrorForModel(err) {
+    switch (err.code) {
+        // Auth + setup
+        case 'unauthorized':
+            return ('StayFinder access is not configured yet. ' +
+                'Run the first-time setup flow: ask the user for their email, ' +
+                'call stayfinder_signup with it, then call stayfinder_verify with the 6-digit code they receive.');
+        case 'token_expired':
+            return ('StayFinder access expired from inactivity (the token slides off after ~7 days unused). ' +
+                'Re-run the signup flow: call stayfinder_signup with the user\'s email — ' +
+                'do NOT ask the user for their email, it is available from the cached credential record. ' +
+                'Then call stayfinder_verify with the new 6-digit code they receive.');
+        case 'tenant_suspended':
+            return ('This StayFinder account has been suspended. ' +
+                'You\'ll need to contact the operator to find out why; this is not something the user can fix from the chat.');
+        // Signup + verify error codes
+        case 'invalid_email':
+            return ('That doesn\'t look like a valid email address. ' +
+                'Ask the user to double-check the spelling and try again.');
+        case 'disposable_email':
+            return ('That email provider isn\'t accepted (it\'s on the disposable-email blocklist). ' +
+                'Ask the user to use a different email address — gmail, fastmail, icloud, or any other regular provider.');
+        case 'signup_rate_limited':
+            return ('Too many signup attempts. ' +
+                `Try again in about ${minutesFromSeconds(err.retryAfterSeconds)} minutes, or use a different email address.`);
+        case 'code_invalid': {
+            const remaining = err.attemptsRemaining;
+            if (typeof remaining === 'number' && remaining > 0) {
+                return (`That code didn't match. You have ${remaining} ${remaining === 1 ? 'attempt' : 'attempts'} left. ` +
+                    'Ask the user to double-check the email — it\'s a 6-digit number from StayFinder.');
+            }
+            // No attempts_remaining means there was no active pending row at all
+            // (for example, the user already verified an earlier code, or signup was
+            // never called). Fall through to "request a new one".
+            return ('That code didn\'t match. ' +
+                'Call stayfinder_signup again to send a fresh code to the user\'s email.');
+        }
+        case 'code_expired':
+            return ('That code expired (codes are only valid for 15 minutes). ' +
+                'Call stayfinder_signup again to send a fresh code to the user\'s email.');
+        case 'code_attempts_exceeded':
+            return ('Too many wrong attempts on that code — it\'s now locked. ' +
+                'Call stayfinder_signup again to send a fresh code to the user\'s email.');
+        // Search-stays operational errors
+        case 'tenant_quota_exceeded':
+            return (`StayFinder hourly search limit reached. ` +
+                `Try again in about ${minutesFromSeconds(err.retryAfterSeconds)} minutes. ` +
+                'Tell the user honestly — do not fall back to web_search or browser; those won\'t give live pricing.');
+        case 'global_quota_exceeded':
+            return ('The shared StayFinder rate limit is exhausted across all users right now. ' +
+                `Try again in about ${minutesFromSeconds(err.retryAfterSeconds)} minutes. ` +
+                'This is operator-side, not the user\'s personal quota.');
+        case 'destination_not_found':
+            return (`Couldn't find that destination: "${err.message}". ` +
+                'Ask the user to be more specific (city + state, or neighborhood + city), or suggest a nearby major city.');
+        case 'destination_ambiguous': {
+            const candidates = err.details?.candidates ?? [];
+            if (candidates.length > 0) {
+                const list = candidates.map((c) => `- ${c.label}`).join('\n');
+                return `Multiple destinations match. Ask the user which one they meant:\n${list}`;
+            }
+            return 'That destination matched multiple places. Ask the user to be more specific.';
+        }
+        case 'expedia_upstream_error':
+        case 'upstream_timeout':
+            return ('The lodging service is having upstream trouble right now. ' +
+                'Tell the user briefly and offer to retry in a minute. ' +
+                `(trace: ${err.traceId ?? err.requestId ?? 'no trace id'})`);
+        case 'upstream_unavailable':
+            return ('The lodging service is temporarily shedding load (circuit breaker is open). ' +
+                `Wait about ${err.retryAfterSeconds ?? 30} seconds and try again. ` +
+                'Tell the user honestly — this is a brief outage, not a permanent failure.');
+        case 'invalid_request':
+        case 'missing_field':
+            return (`Search request was rejected by validation: ${err.message}. ` +
+                'Re-read the error message; usually a date or filter problem. Fix and retry.');
+        case 'internal_error':
+            return ('An internal error happened in the lodging service. ' +
+                `Tell the user briefly and offer to retry. (trace: ${err.traceId ?? err.requestId ?? 'no trace id'})`);
+        default:
+            // Unknown code — surface the raw message + code so we have something
+            // to grep for if it shows up in a session trace.
+            return `StayFinder error: ${err.message} (code: ${err.code})`;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: import("openclaw/plugin-sdk/core").OpenClawPluginConfigSchema;
+    register: NonNullable<import("openclaw/plugin-sdk/core").OpenClawPluginDefinition["register"]>;
+} & Pick<import("openclaw/plugin-sdk/core").OpenClawPluginDefinition, "kind" | "reload" | "nodeHostCommands" | "securityAuditCollectors">;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;AAkBA,wBAWG"}

package/dist/index.js

@@ -0,0 +1,28 @@
+/**
+ * StayFinder OpenClaw plugin entry point.
+ *
+ * Registers three tools:
+ *   - search_stays      — live hotel and vacation rental search
+ *   - stayfinder_signup — request a 6-digit email verification code
+ *   - stayfinder_verify — exchange the code for a token, saved to disk
+ *
+ * The bundled SKILL.md in skills/lodging-search/ tells the model when
+ * and how to use these tools. The skill is loaded automatically by
+ * OpenClaw when the plugin is installed (declared in openclaw.plugin.json).
+ */
+import { definePluginEntry } from 'openclaw/plugin-sdk/core';
+import { createSearchStaysTool } from './tools/search-stays.js';
+import { createStayFinderSignupTool } from './tools/stayfinder-signup.js';
+import { createStayFinderVerifyTool } from './tools/stayfinder-verify.js';
+export default definePluginEntry({
+    id: 'stayfinder',
+    name: 'StayFinder',
+    description: 'Live hotel and vacation rental search via the StayFinder service. ' +
+        'Returns real-time pricing, availability, and booking redirect links.',
+    register(api) {
+        api.registerTool(createSearchStaysTool(api));
+        api.registerTool(createStayFinderSignupTool(api));
+        api.registerTool(createStayFinderVerifyTool(api));
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE1E,eAAe,iBAAiB,CAAC;IAC/B,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,oEAAoE;QACpE,sEAAsE;IACxE,QAAQ,CAAC,GAAG;QACV,GAAG,CAAC,YAAY,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7C,GAAG,CAAC,YAAY,CAAC,0BAA0B,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,GAAG,CAAC,YAAY,CAAC,0BAA0B,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}

package/dist/plugin-config.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Safe reader for the plugin's config block.
+ *
+ * OpenClaw passes plugin config as `api.pluginConfig: Record<string, unknown>`,
+ * which means we have to defensively type-check every field. The shape we
+ * expect is described by the `configSchema` in `openclaw.plugin.json` and
+ * by the `StayFinderPluginConfig` type in types.ts, but the runtime value
+ * is whatever happens to be in the user's `~/.openclaw/openclaw.json` file
+ * — possibly typoed, possibly missing fields, possibly hand-edited.
+ *
+ * The defaults here are the ones a fresh install gets if the user puts
+ * the minimum into their config (just `enabled: true`, no `config` block
+ * at all). They mirror what the README documents.
+ */
+import type { StayFinderPluginConfig } from './types.js';
+/**
+ * The public hosted StayFinder service. Self-hosters can point at their
+ * own deployment by setting `adapter_url` in plugin config.
+ */
+export declare const DEFAULT_ADAPTER_URL = "https://api.stayfinder.riverintel.com";
+export declare const DEFAULT_POS_COUNTRY = "US";
+export declare const DEFAULT_REQUEST_TIMEOUT_MS = 10000;
+/**
+ * Read the plugin config from `api.pluginConfig` and apply defaults.
+ *
+ * Always returns a complete StayFinderPluginConfig object — no field is
+ * undefined except `default_currency`, which is genuinely optional and
+ * the adapter handles its absence by falling back to the POS-country
+ * default. Pass-through of an unset field beats injecting a wrong default.
+ *
+ * Strips `https://` schema validation from `adapter_url`: in dev we want
+ * to allow `http://localhost:8080`, but the configSchema in
+ * openclaw.plugin.json keeps the `https://` requirement to keep production
+ * users honest. The plugin runtime accepts whatever the schema lets through.
+ */
+export declare function readPluginConfig(pluginConfig: unknown | undefined): StayFinderPluginConfig;
+//# sourceMappingURL=plugin-config.d.ts.map

package/dist/plugin-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-config.d.ts","sourceRoot":"","sources":["../src/plugin-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,0CAA0C,CAAC;AAC3E,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAkCjD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,OAAO,GAAG,SAAS,GAChC,sBAAsB,CAYxB"}

package/dist/plugin-config.js

@@ -0,0 +1,63 @@
+/**
+ * Safe reader for the plugin's config block.
+ *
+ * OpenClaw passes plugin config as `api.pluginConfig: Record<string, unknown>`,
+ * which means we have to defensively type-check every field. The shape we
+ * expect is described by the `configSchema` in `openclaw.plugin.json` and
+ * by the `StayFinderPluginConfig` type in types.ts, but the runtime value
+ * is whatever happens to be in the user's `~/.openclaw/openclaw.json` file
+ * — possibly typoed, possibly missing fields, possibly hand-edited.
+ *
+ * The defaults here are the ones a fresh install gets if the user puts
+ * the minimum into their config (just `enabled: true`, no `config` block
+ * at all). They mirror what the README documents.
+ */
+/**
+ * The public hosted StayFinder service. Self-hosters can point at their
+ * own deployment by setting `adapter_url` in plugin config.
+ */
+export const DEFAULT_ADAPTER_URL = 'https://api.stayfinder.riverintel.com';
+export const DEFAULT_POS_COUNTRY = 'US';
+export const DEFAULT_REQUEST_TIMEOUT_MS = 10_000;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const stringField = (raw, key, fallback) => {
+    const value = raw[key];
+    if (typeof value === 'string' && value.length > 0)
+        return value;
+    return fallback;
+};
+const optionalString = (raw, key) => {
+    const value = raw[key];
+    if (typeof value === 'string' && value.length > 0)
+        return value;
+    return undefined;
+};
+const numberField = (raw, key, fallback) => {
+    const value = raw[key];
+    if (typeof value === 'number' && Number.isFinite(value) && value > 0)
+        return value;
+    return fallback;
+};
+/**
+ * Read the plugin config from `api.pluginConfig` and apply defaults.
+ *
+ * Always returns a complete StayFinderPluginConfig object — no field is
+ * undefined except `default_currency`, which is genuinely optional and
+ * the adapter handles its absence by falling back to the POS-country
+ * default. Pass-through of an unset field beats injecting a wrong default.
+ *
+ * Strips `https://` schema validation from `adapter_url`: in dev we want
+ * to allow `http://localhost:8080`, but the configSchema in
+ * openclaw.plugin.json keeps the `https://` requirement to keep production
+ * users honest. The plugin runtime accepts whatever the schema lets through.
+ */
+export function readPluginConfig(pluginConfig) {
+    const raw = isRecord(pluginConfig) ? pluginConfig : {};
+    return {
+        adapter_url: stringField(raw, 'adapter_url', DEFAULT_ADAPTER_URL),
+        default_pos_country: stringField(raw, 'default_pos_country', DEFAULT_POS_COUNTRY),
+        default_currency: optionalString(raw, 'default_currency'),
+        request_timeout_ms: numberField(raw, 'request_timeout_ms', DEFAULT_REQUEST_TIMEOUT_MS),
+    };
+}
+//# sourceMappingURL=plugin-config.js.map

package/dist/plugin-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-config.js","sourceRoot":"","sources":["../src/plugin-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,uCAAuC,CAAC;AAC3E,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACxC,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAEjD,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEvE,MAAM,WAAW,GAAG,CAClB,GAA4B,EAC5B,GAAW,EACX,QAAgB,EACR,EAAE;IACV,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CACrB,GAA4B,EAC5B,GAAW,EACS,EAAE;IACtB,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAClB,GAA4B,EAC5B,GAAW,EACX,QAAgB,EACR,EAAE;IACV,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACnF,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAC9B,YAAiC;IAEjC,MAAM,GAAG,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,OAAO;QACL,WAAW,EAAE,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,mBAAmB,CAAC;QACjE,mBAAmB,EAAE,WAAW,CAAC,GAAG,EAAE,qBAAqB,EAAE,mBAAmB,CAAC;QACjF,gBAAgB,EAAE,cAAc,CAAC,GAAG,EAAE,kBAAkB,CAAC;QACzD,kBAAkB,EAAE,WAAW,CAC7B,GAAG,EACH,oBAAoB,EACpB,0BAA0B,CAC3B;KACF,CAAC;AACJ,CAAC"}

package/dist/thumbnails.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Thumbnail URL resolution upgrade for Expedia CDN images.
+ *
+ * The adapter returns thumbnail_url with the tiny (_t, 70x70) suffix from
+ * Expedia's image CDN (images.trvl-media.com). For richer presentation
+ * contexts (Notion canvases, web UIs, single-property views), the model
+ * benefits from a higher-resolution image.
+ *
+ * Expedia's CDN uses a letter-based suffix convention before the file
+ * extension:
+ *   _t = tiny    (70x70)
+ *   _s = small
+ *   _y = medium  (~500x214, good for cards)
+ *   _l = large
+ *   _z = full-resolution
+ *
+ * This module upgrades _t to _y (medium) by default — large enough for
+ * card layouts, small enough to be reasonable in bandwidth. The suffix
+ * swap is a simple string replacement; the CDN handles the rest.
+ */
+type ImageSuffix = '_t' | '_s' | '_y' | '_l' | '_z';
+/**
+ * Upgrade an Expedia CDN thumbnail URL to a higher resolution.
+ *
+ * Returns the original URL unchanged if it doesn't match the expected
+ * suffix pattern — defensive against non-Expedia URLs or future format
+ * changes.
+ */
+export declare function upgradeThumbnailUrl(url: string, targetSuffix?: ImageSuffix): string;
+export {};
+//# sourceMappingURL=thumbnails.d.ts.map

package/dist/thumbnails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnails.d.ts","sourceRoot":"","sources":["../src/thumbnails.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,KAAK,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAIpD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,WAAkB,GAC/B,MAAM,CAER"}

package/dist/thumbnails.js

@@ -0,0 +1,32 @@
+/**
+ * Thumbnail URL resolution upgrade for Expedia CDN images.
+ *
+ * The adapter returns thumbnail_url with the tiny (_t, 70x70) suffix from
+ * Expedia's image CDN (images.trvl-media.com). For richer presentation
+ * contexts (Notion canvases, web UIs, single-property views), the model
+ * benefits from a higher-resolution image.
+ *
+ * Expedia's CDN uses a letter-based suffix convention before the file
+ * extension:
+ *   _t = tiny    (70x70)
+ *   _s = small
+ *   _y = medium  (~500x214, good for cards)
+ *   _l = large
+ *   _z = full-resolution
+ *
+ * This module upgrades _t to _y (medium) by default — large enough for
+ * card layouts, small enough to be reasonable in bandwidth. The suffix
+ * swap is a simple string replacement; the CDN handles the rest.
+ */
+const SUFFIX_PATTERN = /_(t|s|y|l|z)\.(jpe?g|png|webp)$/i;
+/**
+ * Upgrade an Expedia CDN thumbnail URL to a higher resolution.
+ *
+ * Returns the original URL unchanged if it doesn't match the expected
+ * suffix pattern — defensive against non-Expedia URLs or future format
+ * changes.
+ */
+export function upgradeThumbnailUrl(url, targetSuffix = '_y') {
+    return url.replace(SUFFIX_PATTERN, (_match, _letter, ext) => `${targetSuffix}.${ext}`);
+}
+//# sourceMappingURL=thumbnails.js.map

package/dist/thumbnails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnails.js","sourceRoot":"","sources":["../src/thumbnails.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,MAAM,cAAc,GAAG,kCAAkC,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAW,EACX,eAA4B,IAAI;IAEhC,OAAO,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,YAAY,IAAI,GAAG,EAAE,CAAC,CAAC;AACzF,CAAC"}

package/dist/tool-result.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tiny helper that builds the AgentToolResult shape the OpenClaw runtime
+ * expects. Inlined here instead of importing from `openclaw/plugin-sdk/core`
+ * because the SDK's bundled JS re-exports through a hashed chunk file
+ * (`common-B7pbdYUb.js`) that doesn't resolve cleanly as a named import
+ * from `openclaw/plugin-sdk/core` at test time. The function is 5 lines;
+ * owning it avoids a fragile import.
+ */
+export interface ToolTextContent {
+    type: 'text';
+    text: string;
+}
+export interface ToolResult<T = unknown> {
+    content: ToolTextContent[];
+    details: T;
+}
+export declare function toolTextResult<T>(text: string, details: T): ToolResult<T>;
+export declare function toolJsonResult<T>(payload: T): ToolResult<T>;
+//# sourceMappingURL=tool-result.d.ts.map

package/dist/tool-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.d.ts","sourceRoot":"","sources":["../src/tool-result.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAKzE;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAE3D"}