@agent-relay/integration-prompts 8.8.3

package/README.md

@@ -0,0 +1,17 @@
+# @agent-relay/integration-prompts
+
+Shared prompt builders for Relayfile integration writeback instructions.
+
+```ts
+import {
+  deriveDescriptorsFromMount,
+  prescriptiveInstructions,
+} from '@agent-relay/integration-prompts';
+
+const descriptors = await deriveDescriptorsFromMount({
+  readFile: async (path) => mount.readText(path),
+  listTree: async (path) => mount.listTree(path),
+});
+
+const instructions = prescriptiveInstructions(descriptors);
+```

package/dist/builders.d.ts

@@ -0,0 +1,6 @@
+import type { IntegrationDescriptor } from './types.js';
+export declare function prescriptiveInstructions(descriptors: IntegrationDescriptor[]): string;
+export declare function fullInjectInstructions(descriptors: IntegrationDescriptor[]): string;
+export declare function initialSpawnInstructions(descriptors: IntegrationDescriptor[]): string;
+export declare function slimInstructions(descriptors: IntegrationDescriptor[]): string;
+//# sourceMappingURL=builders.d.ts.map

package/dist/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAA8D,MAAM,YAAY,CAAC;AAEpH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAqBrF;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,qBAAqB,EAAE,GAAG,MAAM,CA0CnF;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAOrF;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAa7E"}

package/dist/builders.js

@@ -0,0 +1,144 @@
+export function prescriptiveInstructions(descriptors) {
+    const integrations = normalizeDescriptors(descriptors);
+    if (integrations.length === 0)
+        return '';
+    const lines = [
+        '## Integration writebacks',
+        'To dispatch an integration action, write a JSON file under the resource path -- do NOT use relay messaging for these actions.',
+        'Read the sibling .schema.json and .create.example.json files under .integrations/discovery/<provider>/ before writing.',
+        'Do not create provider records inside discovery; discovery is schema-only.',
+        '',
+        'Available writeback resources:',
+    ];
+    for (const descriptor of integrations) {
+        lines.push(`- ${labelFor(descriptor)} (${descriptor.mountRoot})`);
+        for (const resource of descriptor.writableResources) {
+            lines.push(`  - ${resourceLine(descriptor, resource)}`);
+        }
+    }
+    return lines.join('\n');
+}
+export function fullInjectInstructions(descriptors) {
+    const integrations = normalizeDescriptors(descriptors);
+    const lines = [
+        '<integrations-update>',
+        'The user has connected the following integrations to this project:',
+    ];
+    if (integrations.length === 0) {
+        lines.push('- none');
+    }
+    else {
+        for (const descriptor of integrations) {
+            lines.push(fullDescriptorLine(descriptor));
+        }
+    }
+    const subscriptions = integrations.flatMap((descriptor) => (descriptor.subscriptions ?? []).map((subscription) => ({
+        provider: subscription.provider ?? descriptor.provider,
+        watches: subscription.watches,
+        targets: subscription.targets ?? [],
+    })));
+    lines.push('');
+    if (subscriptions.length === 0) {
+        lines.push('No integration event subscriptions are active for this project.');
+    }
+    else {
+        lines.push('Active integration event subscriptions for this project:');
+        for (const subscription of subscriptions) {
+            lines.push(subscriptionLine(subscription));
+        }
+        lines.push('You will receive <integration-event> system messages for these subscribed changes. Do not poll these integrations for background changes; wait for the event notification, then read the mounted files for context if needed.');
+    }
+    lines.push('Writeback discovery schemas and examples are mounted through .integrations/discovery/<provider>/ for connected integrations. Use those schemas to create files under the provider paths such as .integrations/slack/channels/<channelId>/messages; do not create provider records inside discovery. Historical provider records are only intentionally downloaded when historical download is enabled. Incoming webhook events do not require downloading history.', '</integrations-update>');
+    return lines.join('\n');
+}
+export function initialSpawnInstructions(descriptors) {
+    const snippet = fullInjectInstructions(descriptors);
+    if (!snippet)
+        return '';
+    return [
+        'Initial project integration context. Treat this as setup context, not as the user task.',
+        snippet,
+    ].join('\n');
+}
+export function slimInstructions(descriptors) {
+    const integrations = normalizeDescriptors(descriptors);
+    if (integrations.length === 0)
+        return '';
+    const names = integrations.map((descriptor) => {
+        const resources = descriptor.writableResources.map((resource) => resource.path).join(', ');
+        return resources ? `${descriptor.provider}: ${resources}` : descriptor.provider;
+    });
+    return [
+        `Connected integrations: ${names.join('; ')}.`,
+        'For integration actions, write JSON under the provider resource path in .integrations; do NOT use relay messaging. Discovery schemas and examples are under .integrations/discovery/<provider>/.',
+    ].join('\n');
+}
+function fullDescriptorLine(descriptor) {
+    const scopeSummary = descriptor.scopeLabels && descriptor.scopeLabels.length > 0
+        ? descriptor.scopeLabels.join(', ')
+        : 'all configured scope';
+    const eventScopes = descriptor.eventScopePaths && descriptor.eventScopePaths.length > 0
+        ? ` (event scope ${descriptor.eventScopePaths.join(', ')})`
+        : ' (no event scope configured)';
+    const discoveryRoot = descriptor.discoveryRoot ?? `.integrations/discovery/${descriptor.provider}`;
+    const writebackPaths = descriptor.writebackPaths && descriptor.writebackPaths.length > 0
+        ? descriptor.writebackPaths
+        : descriptor.writableResources.map((resource) => resource.path);
+    const writebackInstruction = writebackPaths.length > 0
+        ? `create writeback files under ${writebackPaths.join(', ')}, not under discovery`
+        : 'select narrower resources before creating local writeback files; discovery is schema-only';
+    const historyClause = historyText(descriptor, writebackPaths);
+    return `- ${descriptor.provider}: ${scopeSummary}${eventScopes}. Writeback schemas and examples are available at ${discoveryRoot}; ${writebackInstruction}. ${historyClause}`;
+}
+function historyText(descriptor, writebackPaths) {
+    const skipped = descriptor.skippedLocalPaths ?? [];
+    if (descriptor.downloadHistoricalData === true) {
+        if (skipped.length > 0) {
+            return `Historical download is enabled, but these provider paths are not locally poll-mounted: ${skipped.join(', ')}. Select fewer or narrower resources to download local history.`;
+        }
+        return `Historical provider records are available at ${writebackPaths.join(', ') || 'the configured provider paths'}.`;
+    }
+    if (writebackPaths.length === 0) {
+        return 'Local historical provider records are not downloaded. No narrow writeback command roots are mounted; select narrower resources to enable local writeback transport.';
+    }
+    const liveContext = descriptor.liveContextPaths && descriptor.liveContextPaths.length > 0
+        ? `, and live thread context roots are mounted at ${descriptor.liveContextPaths.join(', ')}`
+        : '';
+    return `Local historical provider records are not broadly downloaded. Writeback command roots are mounted at ${writebackPaths.join(', ')}${liveContext}; provider context should be read on demand or through incoming events.`;
+}
+function subscriptionLine(subscription) {
+    const parts = [
+        subscription.watches.length > 0 ? `file changes at ${subscription.watches.join(', ')}` : '',
+        subscription.targets.length > 0 ? `delivered to ${subscription.targets.join(', ')}` : 'delivered to all project agents',
+    ].filter(Boolean);
+    return `- ${subscription.provider}: ${parts.join('; ')}`;
+}
+function resourceLine(descriptor, resource) {
+    const parts = [resource.path];
+    if (resource.createExamplePath)
+        parts.push(`create example ${resource.createExamplePath}`);
+    if (resource.schemaPath)
+        parts.push(`schema ${resource.schemaPath}`);
+    if (resource.description)
+        parts.push(resource.description.replace(/\.$/u, ''));
+    if (parts.length === 1) {
+        parts.push(`write JSON drafts under ${resource.path}`);
+    }
+    const concreteHint = resource.path.startsWith(descriptor.mountRoot) ? '' : ` (mounted under ${descriptor.mountRoot})`;
+    return `${parts.join(' -- ')}${concreteHint}`;
+}
+function normalizeDescriptors(descriptors) {
+    return descriptors
+        .filter((descriptor) => descriptor.provider.trim())
+        .map((descriptor) => ({
+        ...descriptor,
+        provider: descriptor.provider.trim(),
+        mountRoot: descriptor.mountRoot || `.integrations/${descriptor.provider.trim()}`,
+        writableResources: [...descriptor.writableResources].sort((a, b) => a.path.localeCompare(b.path)),
+    }))
+        .sort((a, b) => a.provider.localeCompare(b.provider));
+}
+function labelFor(descriptor) {
+    return descriptor.displayName ? `${descriptor.displayName} / ${descriptor.provider}` : descriptor.provider;
+}
+//# sourceMappingURL=builders.js.map

package/dist/builders.js.map

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

package/dist/discovery.d.ts

@@ -0,0 +1,4 @@
+import type { DeriveDescriptorsOptions, IntegrationDescriptor, MountDiscoveryReader, MountReadFile, WritableResourceDescriptor } from './types.js';
+export declare function deriveDescriptorsFromMount(reader: MountDiscoveryReader | MountReadFile, options?: DeriveDescriptorsOptions | string): Promise<IntegrationDescriptor[]>;
+export declare function parseWritableResources(adapterDoc: string, providerHint?: string): WritableResourceDescriptor[];
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EAEpB,aAAa,EACb,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AA0BpB,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,oBAAoB,GAAG,aAAa,EAC5C,OAAO,GAAE,wBAAwB,GAAG,MAAW,GAC9C,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA0BlC;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,0BAA0B,EAAE,CAK9G"}

package/dist/discovery.js

@@ -0,0 +1,271 @@
+const DEFAULT_DISCOVERY_ROOT = '.integrations/discovery';
+const DEFAULT_KNOWN_PROVIDERS = [
+    'github',
+    'gitlab',
+    'slack',
+    'notion',
+    'linear',
+    'jira',
+    'confluence',
+    'gmail',
+    'google-mail',
+    'google-calendar',
+    'hubspot',
+    'granola',
+    'fathom',
+    'docker-hub',
+    'recall',
+];
+export async function deriveDescriptorsFromMount(reader, options = {}) {
+    const readFile = typeof reader === 'function' ? reader : reader.readFile;
+    const normalized = normalizeOptions(reader, options);
+    const providers = await discoverProviders(readFile, normalized);
+    const descriptors = [];
+    for (const provider of providers) {
+        const providerRoot = joinPath(normalized.discoveryRoot, provider);
+        const adapterDoc = await readFileSafe(readFile, joinPath(providerRoot, '.adapter.md'));
+        const resources = parseWritableResources(adapterDoc ?? '', provider);
+        const discoveredResources = resources.length > 0
+            ? resources
+            : await discoverWritableResourcesFromTree(provider, providerRoot, normalized.listPaths);
+        if (!adapterDoc && discoveredResources.length === 0)
+            continue;
+        descriptors.push({
+            provider,
+            mountRoot: `.integrations/${provider}`,
+            discoveryRoot: providerRoot,
+            writableResources: discoveredResources,
+            description: adapterDoc ? firstParagraph(adapterDoc) : undefined,
+        });
+    }
+    return descriptors.sort((a, b) => a.provider.localeCompare(b.provider));
+}
+export function parseWritableResources(adapterDoc, providerHint) {
+    const rows = parseMarkdownResourceRows(adapterDoc);
+    if (rows.length > 0)
+        return rows;
+    return parseWriteFieldContracts(adapterDoc, providerHint);
+}
+async function discoverProviders(readFile, options) {
+    const providers = new Set();
+    const listed = await listProviderNames(options.discoveryRoot, options.listPaths);
+    for (const provider of listed)
+        providers.add(provider);
+    const manifest = await readJsonSafe(readFile, joinPath(options.discoveryRoot, 'index.json'));
+    for (const provider of providersFromManifest(manifest))
+        providers.add(provider);
+    const adapterProviders = providers.size > 0 ? Array.from(providers) : options.knownProviders;
+    for (const provider of adapterProviders) {
+        if (providers.has(provider))
+            continue;
+        const adapterDoc = await readFileSafe(readFile, joinPath(options.discoveryRoot, provider, '.adapter.md'));
+        if (adapterDoc !== undefined)
+            providers.add(provider);
+    }
+    return Array.from(providers).filter(Boolean).sort();
+}
+async function discoverWritableResourcesFromTree(provider, providerRoot, listPaths) {
+    if (!listPaths)
+        return [];
+    const paths = await listPathsSafe(listPaths, providerRoot);
+    const resources = new Map();
+    for (const path of paths) {
+        const normalized = normalizePath(path);
+        if (!normalized.endsWith('/.create.example.json'))
+            continue;
+        const discoveryRelative = stripPrefix(normalized, providerRoot);
+        const resourceRelative = discoveryRelative.replace(/\/\.create\.example\.json$/u, '');
+        const resourcePath = `/${provider}/${resourceRelative.replace(/^\/+/u, '')}`;
+        resources.set(resourcePath, {
+            path: resourcePath,
+            createExamplePath: normalized,
+            schemaPath: normalized.replace(/\/\.create\.example\.json$/u, '/.schema.json'),
+            name: lastMeaningfulSegment(resourcePath),
+        });
+    }
+    return Array.from(resources.values()).sort(compareResources);
+}
+function parseMarkdownResourceRows(adapterDoc) {
+    const resources = new Map();
+    for (const rawLine of adapterDoc.split(/\r?\n/u)) {
+        const line = rawLine.trim();
+        if (!line.startsWith('|'))
+            continue;
+        if (/^\|\s*-+\s*\|/u.test(line))
+            continue;
+        if (/^\|\s*Resource\s*\|/iu.test(line))
+            continue;
+        const cells = line
+            .slice(1, line.endsWith('|') ? -1 : undefined)
+            .split('|')
+            .map((cell) => stripCode(cell.trim()));
+        if (cells.length < 3)
+            continue;
+        const [resourceCell, schemaCell, createExampleCell, , descriptionCell] = cells;
+        if (!resourceCell || !resourceCell.startsWith('/'))
+            continue;
+        const path = resourceCell.replace(/\/<id>\.json$/u, '').replace(/\/\{id\}\.json$/u, '');
+        resources.set(path, {
+            path,
+            schemaPath: schemaCell && schemaCell.startsWith('/') ? schemaCell : undefined,
+            createExamplePath: createExampleCell && createExampleCell.startsWith('/') ? createExampleCell : undefined,
+            description: descriptionCell || undefined,
+            name: lastMeaningfulSegment(path),
+        });
+    }
+    return Array.from(resources.values()).sort(compareResources);
+}
+function parseWriteFieldContracts(adapterDoc, providerHint) {
+    const resources = new Map();
+    let pendingDescription;
+    let currentPath;
+    for (const rawLine of adapterDoc.split(/\r?\n/u)) {
+        const line = rawLine.trim();
+        const heading = line.match(/^###\s+(.+)$/u);
+        if (heading) {
+            pendingDescription = heading[1]?.trim();
+            currentPath = undefined;
+            continue;
+        }
+        const resource = line.match(/^Resource:\s+`?([^`\s]+)`?/iu);
+        if (resource) {
+            currentPath = normalizeResourcePath(resource[1] ?? '');
+            continue;
+        }
+        const createExample = line.match(/^Create example:\s+`?([^`\s]+)`?/iu);
+        if (createExample && currentPath) {
+            resources.set(currentPath, {
+                path: currentPath,
+                createExamplePath: createExample[1],
+                description: pendingDescription,
+                name: lastMeaningfulSegment(currentPath),
+            });
+        }
+    }
+    if (resources.size === 0 && providerHint) {
+        const fallbackPattern = new RegExp(`/${escapeRegExp(providerHint)}/[^\\s\`|]+/\\.create\\.example\\.json`, 'gu');
+        for (const match of adapterDoc.matchAll(fallbackPattern)) {
+            const createExamplePath = match[0];
+            const path = normalizeResourcePath(createExamplePath.replace(/\/\.create\.example\.json$/u, ''));
+            resources.set(path, {
+                path,
+                createExamplePath,
+                name: lastMeaningfulSegment(path),
+            });
+        }
+    }
+    return Array.from(resources.values()).sort(compareResources);
+}
+function normalizeOptions(reader, options) {
+    const opts = typeof options === 'string' ? { discoveryRoot: options } : options;
+    const readerList = typeof reader === 'function' ? undefined : reader.listPaths ?? reader.listTree;
+    return {
+        discoveryRoot: trimTrailingSlash(opts.discoveryRoot ?? DEFAULT_DISCOVERY_ROOT),
+        knownProviders: opts.knownProviders ?? DEFAULT_KNOWN_PROVIDERS,
+        listPaths: opts.listPaths ?? opts.listTree ?? readerList,
+    };
+}
+async function listProviderNames(root, listPaths) {
+    if (!listPaths)
+        return [];
+    const paths = await listPathsSafe(listPaths, root);
+    const providers = new Set();
+    for (const path of paths) {
+        const relative = stripPrefix(normalizePath(path), root);
+        const provider = relative.split('/').filter(Boolean)[0];
+        if (provider && !provider.startsWith('.'))
+            providers.add(provider);
+    }
+    return Array.from(providers).sort();
+}
+function providersFromManifest(value) {
+    if (Array.isArray(value)) {
+        return value.flatMap((entry) => {
+            if (typeof entry === 'string')
+                return [entry];
+            if (entry && typeof entry === 'object' && typeof entry.provider === 'string') {
+                return [entry.provider];
+            }
+            return [];
+        });
+    }
+    if (value && typeof value === 'object') {
+        const record = value;
+        return [...providersFromManifest(record.providers), ...providersFromManifest(record.integrations)];
+    }
+    return [];
+}
+async function readJsonSafe(readFile, path) {
+    const content = await readFileSafe(readFile, path);
+    if (!content)
+        return undefined;
+    try {
+        return JSON.parse(content);
+    }
+    catch {
+        return undefined;
+    }
+}
+async function readFileSafe(readFile, path) {
+    try {
+        const value = await readFile(path);
+        return typeof value === 'string' ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function listPathsSafe(listPaths, path) {
+    try {
+        const value = await listPaths(path);
+        return Array.isArray(value) ? value.filter((entry) => typeof entry === 'string') : [];
+    }
+    catch {
+        return [];
+    }
+}
+function firstParagraph(markdown) {
+    const lines = markdown
+        .split(/\r?\n/u)
+        .map((line) => line.trim())
+        .filter((line) => line && !line.startsWith('#'));
+    return lines[0];
+}
+function normalizeResourcePath(path) {
+    return path.replace(/\/<id>\.json$/u, '').replace(/\/\{id\}\.json$/u, '');
+}
+function joinPath(...parts) {
+    return parts.map((part, index) => {
+        const trimmed = index === 0 ? trimTrailingSlash(part) : part.replace(/^\/+|\/+$/gu, '');
+        return trimmed;
+    }).filter(Boolean).join('/');
+}
+function normalizePath(path) {
+    return path.replace(/\\/gu, '/').replace(/\/+/gu, '/').replace(/\/$/u, '');
+}
+function trimTrailingSlash(path) {
+    return path.replace(/\/+$/u, '');
+}
+function stripPrefix(path, prefix) {
+    const normalizedPrefix = normalizePath(prefix);
+    const normalizedPath = normalizePath(path);
+    if (normalizedPath === normalizedPrefix)
+        return '';
+    if (normalizedPath.startsWith(`${normalizedPrefix}/`))
+        return normalizedPath.slice(normalizedPrefix.length + 1);
+    return normalizedPath;
+}
+function stripCode(value) {
+    return value.replace(/^`|`$/gu, '').trim();
+}
+function lastMeaningfulSegment(path) {
+    const segments = path.split('/').filter(Boolean);
+    return segments.at(-1)?.replace(/\.(json|md)$/u, '');
+}
+function compareResources(a, b) {
+    return a.path.localeCompare(b.path);
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&');
+}
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { deriveDescriptorsFromMount, parseWritableResources, } from './discovery.js';
+export { fullInjectInstructions, initialSpawnInstructions, prescriptiveInstructions, slimInstructions, } from './builders.js';
+export type { DeriveDescriptorsOptions, IntegrationDescriptor, IntegrationSubscriptionSummary, MaybePromise, MountDiscoveryReader, MountListPaths, MountReadFile, WritableResourceDescriptor, } from './types.js';
+//# 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":"AAAA,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,wBAAwB,EACxB,qBAAqB,EACrB,8BAA8B,EAC9B,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,0BAA0B,GAC3B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { deriveDescriptorsFromMount, parseWritableResources, } from './discovery.js';
+export { fullInjectInstructions, initialSpawnInstructions, prescriptiveInstructions, slimInstructions, } from './builders.js';
+//# 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,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,eAAe,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,42 @@
+export type MaybePromise<T> = T | Promise<T>;
+export interface WritableResourceDescriptor {
+    path: string;
+    createExamplePath?: string;
+    schemaPath?: string;
+    description?: string;
+    name?: string;
+}
+export interface IntegrationSubscriptionSummary {
+    provider?: string;
+    watches: string[];
+    targets?: string[];
+}
+export interface IntegrationDescriptor {
+    provider: string;
+    mountRoot: string;
+    writableResources: WritableResourceDescriptor[];
+    discoveryRoot?: string;
+    displayName?: string;
+    description?: string;
+    scopeLabels?: string[];
+    eventScopePaths?: string[];
+    writebackPaths?: string[];
+    subscriptions?: IntegrationSubscriptionSummary[];
+    downloadHistoricalData?: boolean;
+    liveContextPaths?: string[];
+    skippedLocalPaths?: string[];
+}
+export type MountReadFile = (path: string) => MaybePromise<string | null | undefined>;
+export type MountListPaths = (path: string) => MaybePromise<string[] | null | undefined>;
+export interface MountDiscoveryReader {
+    readFile: MountReadFile;
+    listPaths?: MountListPaths;
+    listTree?: MountListPaths;
+}
+export interface DeriveDescriptorsOptions {
+    discoveryRoot?: string;
+    knownProviders?: string[];
+    listPaths?: MountListPaths;
+    listTree?: MountListPaths;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7C,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,0BAA0B,EAAE,CAAC;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,8BAA8B,EAAE,CAAC;IACjD,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,YAAY,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEtF,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,YAAY,CAAC,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEzF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,aAAa,CAAC;IACxB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@agent-relay/integration-prompts",
+  "version": "8.8.3",
+  "description": "Shared Relayfile integration writeback prompt builders for Agent Relay consumers.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --root ../.. packages/integration-prompts/src/discovery.test.ts packages/integration-prompts/src/builders.test.ts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relay.git",
+    "directory": "packages/integration-prompts"
+  },
+  "license": "Apache-2.0"
+}