glirastes 0.3.2 → 0.5.0

package/dist/server/testing/zod-introspect.js

@@ -0,0 +1,286 @@
+/**
+ * Schema introspection helpers (Zod v3/v4 and generated JSON Schema).
+ *
+ * Centralizes all access to Zod's internal `_zod.def` representation so the
+ * test-suite generators (`edge-cases.ts`, `schema-consistency.ts`) don't each
+ * reach into internals independently. If a future Zod version changes its
+ * internal shape, only this file — covered by `zod-introspect.test.ts` — needs
+ * updating, and the unit tests will catch a silent regression (introspection
+ * returning nothing) instead of letting it ship as a green-but-empty suite.
+ */
+const ZOD_3_TYPES = {
+    ZodArray: 'array',
+    ZodBoolean: 'boolean',
+    ZodCatch: 'catch',
+    ZodDefault: 'default',
+    ZodDiscriminatedUnion: 'union',
+    ZodEffects: 'effects',
+    ZodEnum: 'enum',
+    ZodLazy: 'lazy',
+    ZodNativeEnum: 'enum',
+    ZodNullable: 'nullable',
+    ZodNumber: 'number',
+    ZodObject: 'object',
+    ZodOptional: 'optional',
+    ZodPipeline: 'pipe',
+    ZodReadonly: 'readonly',
+    ZodString: 'string',
+    ZodTuple: 'tuple',
+    ZodUnion: 'union',
+};
+const JSON_SCHEMA_NODE = Symbol('glirastes.json-schema-node');
+const JSON_SCHEMA_REQUIRED = Symbol('glirastes.json-schema-required');
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function jsonSchemaRef(schema) {
+    if (!isRecord(schema))
+        return undefined;
+    const marked = schema;
+    if (marked[JSON_SCHEMA_NODE]) {
+        return marked;
+    }
+    if (isRecord(schema.jsonSchema)) {
+        return {
+            [JSON_SCHEMA_NODE]: schema.jsonSchema,
+            [JSON_SCHEMA_REQUIRED]: true,
+        };
+    }
+    if (!('_def' in schema)
+        && !('_zod' in schema)
+        && ('type' in schema
+            || 'enum' in schema
+            || 'properties' in schema
+            || 'anyOf' in schema
+            || 'oneOf' in schema)) {
+        return {
+            [JSON_SCHEMA_NODE]: schema,
+            [JSON_SCHEMA_REQUIRED]: true,
+        };
+    }
+    return undefined;
+}
+function jsonAllowsNull(node) {
+    if (node.nullable === true)
+        return true;
+    if (Array.isArray(node.type) && node.type.includes('null'))
+        return true;
+    for (const branchKey of ['anyOf', 'oneOf']) {
+        const branches = node[branchKey];
+        if (Array.isArray(branches)
+            && branches.some((branch) => isRecord(branch) && branch.type === 'null')) {
+            return true;
+        }
+    }
+    return false;
+}
+function unwrapJsonRef(ref) {
+    const node = ref[JSON_SCHEMA_NODE];
+    for (const branchKey of ['anyOf', 'oneOf']) {
+        const branches = node[branchKey];
+        if (Array.isArray(branches)) {
+            const branch = branches.find((candidate) => isRecord(candidate) && candidate.type !== 'null');
+            if (isRecord(branch)) {
+                return {
+                    [JSON_SCHEMA_NODE]: branch,
+                    [JSON_SCHEMA_REQUIRED]: ref[JSON_SCHEMA_REQUIRED],
+                };
+            }
+        }
+    }
+    return ref;
+}
+function jsonSchemaType(ref) {
+    const node = unwrapJsonRef(ref)[JSON_SCHEMA_NODE];
+    if (Array.isArray(node.enum))
+        return 'enum';
+    if (Array.isArray(node.type)) {
+        return node.type.find((value) => value !== 'null');
+    }
+    return typeof node.type === 'string' ? node.type : undefined;
+}
+/** Read and normalize Zod v3/v4 internal schema definitions. */
+function getDef(schema) {
+    const v4 = schema?._zod?.def;
+    if (v4)
+        return v4;
+    const v3 = schema?._def;
+    if (!v3)
+        return undefined;
+    return {
+        ...v3,
+        type: ZOD_3_TYPES[v3.typeName] ?? v3.typeName,
+        element: v3.type,
+        entries: v3.values
+            ? Object.fromEntries(v3.values.map((value) => [value, value]))
+            : v3.values,
+        in: v3.in ?? v3.schema,
+    };
+}
+/** Wrapper types that hold their inner schema in `def.innerType`. */
+const WRAPPER_TYPES = new Set([
+    'optional',
+    'nullable',
+    'default',
+    'prefault',
+    'catch',
+    'readonly',
+    'nonoptional',
+]);
+/** The normalized Zod v4 type tag (e.g. 'object', 'string', 'array', 'enum'). */
+export function getSchemaType(schema) {
+    const json = jsonSchemaRef(schema);
+    if (json)
+        return jsonSchemaType(json);
+    return getDef(schema)?.type;
+}
+/**
+ * True if the field is optional, nullable, or has a default — i.e. an input
+ * is not strictly required to provide a concrete value. Matches the historical
+ * behaviour of the edge-case generator, which skips the "rejects missing"
+ * boundary test for any of these.
+ */
+export function isOptional(schema) {
+    const json = jsonSchemaRef(schema);
+    if (json) {
+        const node = json[JSON_SCHEMA_NODE];
+        return (!json[JSON_SCHEMA_REQUIRED]
+            || 'default' in node
+            || jsonAllowsNull(node));
+    }
+    const type = getSchemaType(schema);
+    return (type === 'optional' ||
+        type === 'default' ||
+        type === 'prefault' ||
+        type === 'nullable');
+}
+/** Strip optional/nullable/default/pipe wrappers to the base schema. */
+export function unwrap(schema) {
+    const json = jsonSchemaRef(schema);
+    if (json)
+        return unwrapJsonRef(json);
+    const def = getDef(schema);
+    const type = def?.type;
+    if (WRAPPER_TYPES.has(type))
+        return unwrap(def.innerType);
+    if (type === 'pipe')
+        return unwrap(def.in);
+    if (type === 'effects')
+        return unwrap(def.schema);
+    return schema;
+}
+/** The base Zod type tag after unwrapping (e.g. an optional string → 'string'). */
+export function getBaseType(schema) {
+    return getSchemaType(unwrap(schema));
+}
+/**
+ * The field map of an object schema, unwrapping optional/default/pipe wrappers.
+ * Returns null for non-object schemas.
+ */
+export function getObjectShape(schema) {
+    const json = jsonSchemaRef(schema);
+    if (json) {
+        const node = unwrapJsonRef(json)[JSON_SCHEMA_NODE];
+        if (jsonSchemaType(json) !== 'object' || !isRecord(node.properties)) {
+            return null;
+        }
+        const required = new Set(Array.isArray(node.required)
+            ? node.required.filter((field) => typeof field === 'string')
+            : []);
+        return Object.fromEntries(Object.entries(node.properties)
+            .filter((entry) => isRecord(entry[1]))
+            .map(([field, child]) => [
+            field,
+            {
+                [JSON_SCHEMA_NODE]: child,
+                [JSON_SCHEMA_REQUIRED]: required.has(field),
+            },
+        ]));
+    }
+    const def = getDef(schema);
+    if (!def)
+        return null;
+    if (def.type === 'object') {
+        return (typeof def.shape === 'function' ? def.shape() : def.shape);
+    }
+    if (WRAPPER_TYPES.has(def.type) && def.innerType) {
+        return getObjectShape(def.innerType);
+    }
+    if (def.type === 'pipe' && def.in) {
+        return getObjectShape(def.in);
+    }
+    if (def.type === 'effects' && def.schema) {
+        return getObjectShape(def.schema);
+    }
+    return null;
+}
+/** The string members of an enum schema (after unwrapping). */
+export function getEnumValues(schema) {
+    const json = jsonSchemaRef(schema);
+    if (json) {
+        const values = unwrapJsonRef(json)[JSON_SCHEMA_NODE].enum;
+        return Array.isArray(values)
+            ? values.filter((value) => typeof value === 'string')
+            : [];
+    }
+    const def = getDef(unwrap(schema));
+    if (def?.type !== 'enum')
+        return [];
+    return Object.values(def.entries).filter((v) => typeof v === 'string');
+}
+/** The element schema of an array (after unwrapping), or null. */
+export function getArrayElement(schema) {
+    const json = jsonSchemaRef(schema);
+    if (json) {
+        const node = unwrapJsonRef(json)[JSON_SCHEMA_NODE];
+        return isRecord(node.items)
+            ? {
+                [JSON_SCHEMA_NODE]: node.items,
+                [JSON_SCHEMA_REQUIRED]: true,
+            }
+            : null;
+    }
+    const def = getDef(unwrap(schema));
+    return def?.type === 'array' ? def.element : null;
+}
+/** The `.max(n)` length constraint on an array schema, or null. */
+export function getArrayMax(schema) {
+    const json = jsonSchemaRef(schema);
+    if (json) {
+        const maximum = unwrapJsonRef(json)[JSON_SCHEMA_NODE].maxItems;
+        return typeof maximum === 'number' ? maximum : null;
+    }
+    const def = getDef(unwrap(schema));
+    if (def?.type !== 'array')
+        return null;
+    if (def.maxLength?.value !== undefined) {
+        return def.maxLength.value;
+    }
+    for (const check of def.checks ?? []) {
+        const cd = check?._zod?.def;
+        if (cd?.check === 'max_length')
+            return cd.maximum;
+    }
+    return null;
+}
+/** True if a string schema carries the given format check (e.g. 'uuid'). */
+export function hasStringFormat(schema, format) {
+    const json = jsonSchemaRef(schema);
+    if (json) {
+        const node = unwrapJsonRef(json)[JSON_SCHEMA_NODE];
+        return jsonSchemaType(json) === 'string' && node.format === format;
+    }
+    const def = getDef(unwrap(schema));
+    if (def?.type !== 'string')
+        return false;
+    return (def.checks ?? []).some((check) => {
+        const cd = check?._zod?.def;
+        return ((cd?.check === 'string_format' && cd?.format === format)
+            || check?.kind === format);
+    });
+}
+/** True if a string schema is a UUID. */
+export function isUuidString(schema) {
+    return hasStringFormat(schema, 'uuid');
+}
+//# sourceMappingURL=zod-introspect.js.map

package/dist/server/testing/zod-introspect.js.map

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

package/dist/stt/index.d.ts

@@ -0,0 +1,5 @@
+export { SttSessionController, type SttProviderAdapter, type SttProviderConnection, type SttProviderEvents, type SttSessionControllerOptions, type SttSessionPhase, type SttSessionSnapshot, } from '../react/stt/controller.js';
+export { RecordedSttAdapter, encodeWav, type RecordedSttAdapterOptions, } from '../react/stt/recorded.js';
+export { DeepgramSttAdapter, createDeepgramSegmentParser, type DeepgramSttAdapterOptions, } from '../react/stt/deepgram.js';
+export { applySttSegment, createSttTranscript, type SttSegment, type SttTranscript, } from '../react/stt/segments.js';
+export { createStreamAnalyser, type StreamAnalyser, } from '../react/stt/waveform.js';

package/dist/stt/index.js

@@ -0,0 +1,6 @@
+export { SttSessionController, } from '../react/stt/controller.js';
+export { RecordedSttAdapter, encodeWav, } from '../react/stt/recorded.js';
+export { DeepgramSttAdapter, createDeepgramSegmentParser, } from '../react/stt/deepgram.js';
+export { applySttSegment, createSttTranscript, } from '../react/stt/segments.js';
+export { createStreamAnalyser, } from '../react/stt/waveform.js';
+//# sourceMappingURL=index.js.map

package/dist/stt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stt/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAOrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,SAAS,GAEV,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kBAAkB,EAClB,2BAA2B,GAE5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,eAAe,EACf,mBAAmB,GAGpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,oBAAoB,GAErB,MAAM,0BAA0B,CAAC"}

package/dist/sync/app-setup-client.d.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { AppSetupAssessmentModeSchema, type AppSetupArtifact, type AppSetupStatus } from '../contracts/app-setup.js';
+export interface AppSetupRun {
+    runId: string;
+    appId: string;
+    status: AppSetupStatus;
+    progress?: {
+        completed: number;
+        total: number;
+    };
+    artifactDigest?: string;
+    updatedAt: string;
+}
+export interface CreateAppSetupRun {
+    runId: string;
+    assessmentMode: z.infer<typeof AppSetupAssessmentModeSchema>;
+    discoveryDigest: string;
+}
+export interface UpdateAppSetupStatus {
+    status: AppSetupStatus;
+    progress?: {
+        completed: number;
+        total: number;
+    };
+}
+export interface AppSetupSyncOptions {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
+export declare class AppSetupClient {
+    private readonly options;
+    constructor(options: {
+        baseUrl: string;
+        setupApiKey: string;
+        appId: string;
+        fetchImpl?: typeof fetch;
+    });
+    createRun(input: CreateAppSetupRun, signal?: AbortSignal): Promise<AppSetupRun>;
+    updateStatus(runId: string, update: UpdateAppSetupStatus): Promise<AppSetupRun>;
+    uploadArtifact(value: unknown, signal?: AbortSignal): Promise<AppSetupRun>;
+    syncArtifact(value: unknown, options?: AppSetupSyncOptions): Promise<AppSetupRun>;
+    getRun(runId: string): Promise<AppSetupRun>;
+    private request;
+    private url;
+}
+export type { AppSetupArtifact };

package/dist/sync/app-setup-client.js

@@ -0,0 +1,137 @@
+import { z } from 'zod';
+import { AppSetupArtifactSchema, AppSetupAssessmentModeSchema, AppSetupStatusSchema, } from '../contracts/app-setup.js';
+const uuid = z.uuid();
+const digest = z.string().regex(/^sha256:(?:[A-Za-z0-9_-]{43}|[A-Za-z0-9+/]{43}=)$/);
+const progressSchema = z.object({
+    completed: z.number().int().nonnegative(),
+    total: z.number().int().nonnegative(),
+}).strict().refine((progress) => progress.completed <= progress.total, 'Completed progress cannot exceed total progress');
+const runResponseSchema = z.object({
+    runId: uuid,
+    appId: uuid,
+    status: AppSetupStatusSchema,
+    progress: progressSchema.optional(),
+    artifactDigest: digest.optional(),
+    updatedAt: z.iso.datetime({ offset: true }),
+}).strict();
+export class AppSetupClient {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async createRun(input, signal) {
+        const body = z.object({
+            runId: uuid,
+            assessmentMode: AppSetupAssessmentModeSchema,
+            discoveryDigest: digest,
+        }).strict().parse(input);
+        return this.request('/runs', {
+            method: 'POST',
+            body: JSON.stringify(body),
+            signal,
+        }, body.runId);
+    }
+    async updateStatus(runId, update) {
+        const parsedRunId = uuid.parse(runId);
+        const body = z.object({
+            status: AppSetupStatusSchema,
+            progress: progressSchema.optional(),
+        }).strict().parse(update);
+        return this.request(`/runs/${encodeURIComponent(parsedRunId)}/status`, {
+            method: 'PATCH',
+            body: JSON.stringify(body),
+        }, parsedRunId);
+    }
+    async uploadArtifact(value, signal) {
+        const artifact = AppSetupArtifactSchema.parse(value);
+        if (artifact.appId !== this.options.appId) {
+            throw new Error('App setup artifact targets a different app');
+        }
+        return this.request(`/runs/${encodeURIComponent(artifact.runId)}/artifact`, {
+            method: 'PUT',
+            body: JSON.stringify(artifact),
+            signal,
+        }, artifact.runId);
+    }
+    async syncArtifact(value, options = {}) {
+        const artifact = AppSetupArtifactSchema.parse(value);
+        if (artifact.appId !== this.options.appId) {
+            throw new Error('App setup artifact targets a different app');
+        }
+        const timeoutMs = z.number().int().positive().max(300_000).parse(options.timeoutMs ?? 30_000);
+        const controller = new AbortController();
+        let timedOut = false;
+        const cancel = () => { controller.abort(); };
+        if (options.signal?.aborted)
+            cancel();
+        else
+            options.signal?.addEventListener('abort', cancel, { once: true });
+        const timer = setTimeout(() => {
+            timedOut = true;
+            controller.abort();
+        }, timeoutMs);
+        try {
+            await this.createRun({
+                runId: artifact.runId,
+                assessmentMode: artifact.assessmentMode,
+                discoveryDigest: artifact.discoveryDigest,
+            }, controller.signal);
+            return await this.uploadArtifact(artifact, controller.signal);
+        }
+        catch (error) {
+            if (timedOut) {
+                throw new Error('Glirastes app setup request timed out');
+            }
+            if (options.signal?.aborted) {
+                throw new Error('Glirastes app setup request cancelled');
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timer);
+            options.signal?.removeEventListener('abort', cancel);
+        }
+    }
+    async getRun(runId) {
+        const parsedRunId = uuid.parse(runId);
+        return this.request(`/runs/${encodeURIComponent(parsedRunId)}`, { method: 'GET' }, parsedRunId);
+    }
+    async request(path, init, expectedRunId) {
+        let response;
+        try {
+            response = await (this.options.fetchImpl ?? fetch)(this.url(path), {
+                ...init,
+                headers: {
+                    authorization: `Bearer ${this.options.setupApiKey}`,
+                    ...(init.body ? { 'content-type': 'application/json' } : {}),
+                },
+            });
+        }
+        catch {
+            throw new Error('Glirastes app setup request failed (network)');
+        }
+        if (!response.ok) {
+            throw new Error(`Glirastes app setup request failed (${response.status})`);
+        }
+        let value;
+        try {
+            value = await response.json();
+        }
+        catch {
+            throw new Error('Invalid Glirastes app setup response');
+        }
+        const parsed = runResponseSchema.safeParse(value);
+        if (!parsed.success
+            || parsed.data.appId !== this.options.appId
+            || parsed.data.runId !== expectedRunId) {
+            throw new Error('Invalid Glirastes app setup response');
+        }
+        return parsed.data;
+    }
+    url(path) {
+        return `${this.options.baseUrl.replace(/\/$/, '')}`
+            + `/v2/apps/${encodeURIComponent(this.options.appId)}`
+            + `/runtime-setup${path}`;
+    }
+}
+//# sourceMappingURL=app-setup-client.js.map

package/dist/sync/app-setup-client.js.map

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

package/dist/sync/capability-report.d.ts

@@ -0,0 +1,41 @@
+import { type AppSetupArtifact } from '../contracts/app-setup.js';
+/** `sha256:` plus 43 base64url characters, the form the Platform registers (P08b Task 9). */
+export declare const DISCOVERY_DIGEST_PATTERN: RegExp;
+/**
+ * Runner capability `policyRelaxations` (D16): the version of the relaxation
+ * rule this runner applies to signed Platform decisions (pinned, up to tier 2,
+ * never over a local lock of its code report). The Platform shows a stored
+ * relaxation of confirmation as effective only for environments whose runner
+ * reports it; everywhere else it stays pending.
+ */
+export declare const POLICY_RELAXATIONS_VERSION: 1;
+/**
+ * What a runner tells the Platform about the code it runs (spec 4.10.6): the
+ * committed, content-free setup artifact of that code. It describes tools and
+ * never enables any.
+ */
+export interface CapabilityReport {
+    artifact: AppSetupArtifact;
+    discoveryDigest: string;
+}
+export interface CapabilityReportResult {
+    discoveryDigest: string;
+    runId: string;
+    /** false: the Platform already held the artifact of this run. */
+    uploaded: boolean;
+}
+export declare function capabilityReportFrom(setupArtifact: unknown): CapabilityReport;
+/**
+ * Uploads the report through the app setup transport with the runner's
+ * app-bound runtime key. Run identities are content-derived, so a repeated
+ * upload of the same artifact names the same run; once the Platform holds its
+ * artifact, nothing more is sent.
+ */
+export declare function uploadCapabilityReport(options: {
+    baseUrl: string;
+    apiKey: string;
+    appId: string;
+    report: CapabilityReport;
+    fetchImpl?: typeof fetch;
+    signal?: AbortSignal;
+}): Promise<CapabilityReportResult>;

package/dist/sync/capability-report.js

@@ -0,0 +1,48 @@
+import { AppSetupArtifactSchema } from '../contracts/app-setup.js';
+import { AppSetupClient } from './app-setup-client.js';
+/** `sha256:` plus 43 base64url characters, the form the Platform registers (P08b Task 9). */
+export const DISCOVERY_DIGEST_PATTERN = /^sha256:[A-Za-z0-9_-]{43}$/;
+/**
+ * Runner capability `policyRelaxations` (D16): the version of the relaxation
+ * rule this runner applies to signed Platform decisions (pinned, up to tier 2,
+ * never over a local lock of its code report). The Platform shows a stored
+ * relaxation of confirmation as effective only for environments whose runner
+ * reports it; everywhere else it stays pending.
+ */
+export const POLICY_RELAXATIONS_VERSION = 1;
+export function capabilityReportFrom(setupArtifact) {
+    const artifact = AppSetupArtifactSchema.parse(setupArtifact);
+    if (!DISCOVERY_DIGEST_PATTERN.test(artifact.discoveryDigest)) {
+        throw new Error('The setup artifact discoveryDigest is not a sha256 digest');
+    }
+    return { artifact, discoveryDigest: artifact.discoveryDigest };
+}
+/**
+ * Uploads the report through the app setup transport with the runner's
+ * app-bound runtime key. Run identities are content-derived, so a repeated
+ * upload of the same artifact names the same run; once the Platform holds its
+ * artifact, nothing more is sent.
+ */
+export async function uploadCapabilityReport(options) {
+    const { artifact } = options.report;
+    if (artifact.appId !== options.appId) {
+        throw new Error('Capability report targets a different app');
+    }
+    const client = new AppSetupClient({
+        baseUrl: options.baseUrl,
+        setupApiKey: options.apiKey,
+        appId: options.appId,
+        ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
+    });
+    const run = await client.createRun({
+        runId: artifact.runId,
+        assessmentMode: artifact.assessmentMode,
+        discoveryDigest: artifact.discoveryDigest,
+    }, options.signal);
+    const result = { discoveryDigest: artifact.discoveryDigest, runId: artifact.runId };
+    if (run.artifactDigest)
+        return { ...result, uploaded: false };
+    await client.uploadArtifact(artifact, options.signal);
+    return { ...result, uploaded: true };
+}
+//# sourceMappingURL=capability-report.js.map

package/dist/sync/capability-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-report.js","sourceRoot":"","sources":["../../src/sync/capability-report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAyB,MAAM,2BAA2B,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,wBAAwB,GAAG,4BAA4B,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAU,CAAC;AAmBrD,MAAM,UAAU,oBAAoB,CAAC,aAAsB;IACzD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC7D,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,CAAC,eAAe,EAAE,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,OAO5C;IACC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IACpC,IAAI,QAAQ,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,OAAO,CAAC,MAAM;QAC3B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/D,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC;QACjC,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,eAAe,EAAE,QAAQ,CAAC,eAAe;KAC1C,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,MAAM,MAAM,GAAG,EAAE,eAAe,EAAE,QAAQ,CAAC,eAAe,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IACpF,IAAI,GAAG,CAAC,cAAc;QAAE,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC9D,MAAM,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC"}

package/dist/sync/connection-lookup.d.ts

@@ -0,0 +1,19 @@
+/** What the Platform answers for a runtime key (`GET /v1/runtime/connection`). */
+export interface ResolvedRuntimeConnection {
+    baseUrl: string;
+    appId: string;
+    environmentId: string;
+    runnerKey: string;
+}
+/**
+ * Asks the Platform which app, environment and runner a runtime key was
+ * issued for, so a connected app needs only `GLIRASTES_API_KEY`. Errors name
+ * the operation and status only (401 invalid key, 409
+ * `connection_key_unbound` for a key not issued by a pairing).
+ */
+export declare function lookupRuntimeConnection(options: {
+    baseUrl: string;
+    apiKey: string;
+    fetchImpl?: typeof fetch;
+    signal?: AbortSignal;
+}): Promise<ResolvedRuntimeConnection>;