@fatagnus/dink-convex 2.0.2 → 2.7.0

package/README.md

@@ -262,6 +262,64 @@ Set these in your Convex dashboard:
 - `createSyncCrons({ internal })` - Creates cron job for outbox processing
 - `createSyncMutation(mutation, tables, options)` - Creates sync-enabled mutation wrapper
 
+### Introspection Functions
+
+- `describeEdgeServices(ctx, serviceName)` - Describe an edge service by name, returning its ServiceDescriptor
+- `getLLMContext(ctx, serviceNames?)` - Get LLM-friendly context (llm.txt format) for edge services
+
+#### describeEdgeServices
+
+Returns structured metadata about an edge service:
+
+```typescript
+import { describeEdgeServices } from "@fatagnus/dink-convex";
+import { action } from "./_generated/server";
+import { v } from "convex/values";
+
+export const getServiceInfo = action({
+  args: { serviceName: v.string() },
+  handler: async (ctx, args) => {
+    const descriptor = await describeEdgeServices(ctx, args.serviceName);
+    return {
+      name: descriptor.name,
+      version: descriptor.version,
+      description: descriptor.description,
+      methods: descriptor.methods?.map(m => ({
+        name: m.name,
+        description: m.description,
+      })),
+    };
+  },
+});
+```
+
+#### getLLMContext
+
+Returns human/AI-readable documentation for services in llm.txt format:
+
+```typescript
+import { getLLMContext } from "@fatagnus/dink-convex";
+import { action } from "./_generated/server";
+import { v } from "convex/values";
+
+// Get context for all services
+export const getAllServiceDocs = action({
+  handler: async (ctx) => {
+    return await getLLMContext(ctx);
+  },
+});
+
+// Get context for specific services
+export const getServiceDocs = action({
+  args: { services: v.array(v.string()) },
+  handler: async (ctx, args) => {
+    return await getLLMContext(ctx, args.services);
+  },
+});
+```
+
+Both functions require `DINK_URL` and `DINK_APP_SYNC_KEY` environment variables to be configured.
+
 ## Troubleshooting
 
 ### "DINK_APP_SYNC_KEY environment variable is not configured"

package/dist/index.d.ts

@@ -65,6 +65,7 @@ export { createSyncMutation, type SyncCronsConfig } from "./factories.js";
 export { syncTriggers, registerSyncedTable, isSyncedTable, getSyncConfig, createDeltaRecord, createOutboxRecord, createSyncTriggerHandler, createSyncTriggerHandlerAsync, createSyncTriggerHandlerWithScheduling, scheduleImmediateProcessing, getNextSeq, getNextSeqAsync, createSequenceCounter, checkSyncConfigEnabled, createSyncConfigChecker, createConfigAwareSyncTriggerHandler, createSyncTriggers, createSyncTriggersWithHandlers, customMutation, type SequenceCounter, } from "./triggers.js";
 export { callEdge, scatterCall, discoverEdges, getEdgeRpcConfig, buildCallEdgeUrl, buildScatterCallUrl, buildDiscoverEdgesUrl, buildCallEdgePayload, buildScatterCallPayload, parseCallEdgeResponse, parseScatterCallResponse, parseDiscoverEdgesResponse, EdgeRpcError, EDGE_RPC_ERROR_CODES, type CallEdgeOptions, type ScatterCallOptions, type DiscoverEdgesOptions, type CallEdgeResult, type ScatterCallResult, type ScatterCallResultItem, type EdgeInfo, type EdgeRpcConfig, } from "./edgeRpc.js";
 export { registerReplicateComponent, hasReplicateComponent, getReplicateComponent, clearReplicateComponent, forwardToReplicate, type ReplicateComponent, type DeltaData, type ForwardContext, } from "./replicateBridge.js";
-export declare const VERSION = "2.0.0";
+export { describeEdgeServices, getLLMContext, getIntrospectConfig, buildDescribeUrl, buildLLMContextUrl, parseDescribeResponse, parseLLMContextResponse, IntrospectError, INTROSPECT_ERROR_CODES, type ServiceDescriptor, type MethodDescriptor, type ServiceAIContext, type MethodAIContext, type IntrospectConfig, } from "./introspect.js";
+export declare const VERSION = "2.4.0";
 export type { SyncedTableConfig } from "./schema.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AAGH,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAG1E,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,6BAA6B,EAC7B,sCAAsC,EACtC,2BAA2B,EAC3B,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,mCAAmC,EACnC,kBAAkB,EAClB,8BAA8B,EAC9B,cAAc,EACd,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,YAAY,EACZ,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACb,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC;AAG9B,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AAGH,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAG1E,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,6BAA6B,EAC7B,sCAAsC,EACtC,2BAA2B,EAC3B,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,mCAAmC,EACnC,kBAAkB,EAClB,8BAA8B,EAC9B,cAAc,EACd,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,YAAY,EACZ,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACb,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -72,6 +72,8 @@ export { syncTriggers, registerSyncedTable, isSyncedTable, getSyncConfig, create
 export { callEdge, scatterCall, discoverEdges, getEdgeRpcConfig, buildCallEdgeUrl, buildScatterCallUrl, buildDiscoverEdgesUrl, buildCallEdgePayload, buildScatterCallPayload, parseCallEdgeResponse, parseScatterCallResponse, parseDiscoverEdgesResponse, EdgeRpcError, EDGE_RPC_ERROR_CODES, } from "./edgeRpc.js";
 // Replicate bridge utility
 export { registerReplicateComponent, hasReplicateComponent, getReplicateComponent, clearReplicateComponent, forwardToReplicate, } from "./replicateBridge.js";
+// Introspection helpers
+export { describeEdgeServices, getLLMContext, getIntrospectConfig, buildDescribeUrl, buildLLMContextUrl, parseDescribeResponse, parseLLMContextResponse, IntrospectError, INTROSPECT_ERROR_CODES, } from "./introspect.js";
 // Component version
-export const VERSION = "2.0.0";
+export const VERSION = "2.4.0";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AAEH,iBAAiB;AACjB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAErB,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GAEpB,MAAM,WAAW,CAAC;AAEnB,gFAAgF;AAChF,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAOhB,MAAM,oBAAoB,CAAC;AAE5B,sEAAsE;AACtE,OAAO,EAAE,kBAAkB,EAAwB,MAAM,gBAAgB,CAAC;AAE1E,+CAA+C;AAC/C,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,6BAA6B,EAC7B,sCAAsC,EACtC,2BAA2B,EAC3B,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,mCAAmC,EACnC,kBAAkB,EAClB,8BAA8B,EAC9B,cAAc,GAEf,MAAM,eAAe,CAAC;AAEvB,2BAA2B;AAC3B,OAAO,EACL,QAAQ,EACR,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,YAAY,EACZ,oBAAoB,GASrB,MAAM,cAAc,CAAC;AAEtB,2BAA2B;AAC3B,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,GAInB,MAAM,sBAAsB,CAAC;AAE9B,oBAAoB;AACpB,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AAEH,iBAAiB;AACjB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAErB,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GAEpB,MAAM,WAAW,CAAC;AAEnB,gFAAgF;AAChF,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAOhB,MAAM,oBAAoB,CAAC;AAE5B,sEAAsE;AACtE,OAAO,EAAE,kBAAkB,EAAwB,MAAM,gBAAgB,CAAC;AAE1E,+CAA+C;AAC/C,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,6BAA6B,EAC7B,sCAAsC,EACtC,2BAA2B,EAC3B,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,mCAAmC,EACnC,kBAAkB,EAClB,8BAA8B,EAC9B,cAAc,GAEf,MAAM,eAAe,CAAC;AAEvB,2BAA2B;AAC3B,OAAO,EACL,QAAQ,EACR,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,YAAY,EACZ,oBAAoB,GASrB,MAAM,cAAc,CAAC;AAEtB,2BAA2B;AAC3B,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,GAInB,MAAM,sBAAsB,CAAC;AAE9B,wBAAwB;AACxB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,sBAAsB,GAMvB,MAAM,iBAAiB,CAAC;AAEzB,oBAAoB;AACpB,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/introspect.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Introspection Helpers for Convex
+ *
+ * These helpers allow Convex actions to introspect edge services and get
+ * LLM-friendly context via dinkd HTTP endpoints.
+ *
+ * @module introspect
+ */
+/**
+ * Action context type (minimal interface for fetch operations).
+ * In generated code, this will be the full Convex ActionCtx.
+ */
+interface ActionCtx {
+}
+/**
+ * MethodAIContext provides AI-specific guidance for understanding and using a method.
+ */
+export interface MethodAIContext {
+    /** When this method should be called */
+    when_to_use?: string;
+    /** Why to use this method over alternatives */
+    why_to_use?: string;
+    /** Instructions on how to use this method correctly */
+    how_to_use?: string;
+    /** Conditions that must be true before calling this method */
+    preconditions?: string[];
+    /** Side effects that occur when calling this method */
+    side_effects?: string[];
+    /** Names of related methods that may be useful */
+    related_methods?: string[];
+    /** Scenarios describing when to use this method */
+    scenarios?: string[];
+}
+/**
+ * ServiceAIContext provides AI-specific guidance for understanding a service.
+ */
+export interface ServiceAIContext {
+    /** High-level description of what this service does */
+    overview?: string;
+    /** List of capabilities this service provides */
+    capabilities?: string[];
+    /** Known limitations of this service */
+    limitations?: string[];
+}
+/**
+ * MethodDescriptor provides complete metadata about a service method.
+ */
+export interface MethodDescriptor {
+    /** Method name */
+    name: string;
+    /** Human-readable description of what this method does */
+    description?: string;
+    /** JSON Schema describing the input parameters */
+    input_schema?: Record<string, unknown>;
+    /** JSON Schema describing the output */
+    output_schema?: Record<string, unknown>;
+    /** Tags for categorization and filtering */
+    tags?: string[];
+    /** AI-specific context for this method */
+    ai_context?: MethodAIContext;
+}
+/**
+ * ServiceDescriptor provides complete metadata about a service.
+ */
+export interface ServiceDescriptor {
+    /** Service name */
+    name: string;
+    /** Service version (semver recommended) */
+    version: string;
+    /** Human-readable description of this service */
+    description?: string;
+    /** Methods provided by this service */
+    methods?: MethodDescriptor[];
+    /** AI-specific context for this service */
+    ai_context?: ServiceAIContext;
+    /** Names of related services */
+    related_services?: string[];
+}
+/**
+ * Configuration for introspection operations.
+ */
+export interface IntrospectConfig {
+    /** dinkd URL (from DINK_URL env var) */
+    dinkUrl: string | undefined;
+    /** App sync key (from DINK_APP_SYNC_KEY env var) */
+    appSyncKey: string | undefined;
+}
+/**
+ * Error codes for introspection operations.
+ */
+export declare const INTROSPECT_ERROR_CODES: {
+    /** DINK_URL or DINK_APP_SYNC_KEY not configured */
+    readonly MISSING_CONFIG: "MISSING_CONFIG";
+    /** Network error during HTTP request */
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    /** Service not found */
+    readonly NOT_FOUND: "NOT_FOUND";
+    /** Authentication failed */
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    /** Server returned an error */
+    readonly SERVER_ERROR: "SERVER_ERROR";
+    /** Invalid input */
+    readonly INVALID_INPUT: "INVALID_INPUT";
+};
+/**
+ * Error type for introspection operations.
+ */
+export declare class IntrospectError extends Error {
+    /** Error code */
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * Get introspection configuration from environment variables.
+ *
+ * @returns Configuration object with dinkUrl and appSyncKey
+ */
+export declare function getIntrospectConfig(): IntrospectConfig;
+/**
+ * Build URL for single service describe endpoint.
+ *
+ * @param baseUrl - Base dinkd URL
+ * @param serviceName - Name of the service to describe
+ * @returns Full URL for /api/services/:service/llm.txt
+ */
+export declare function buildDescribeUrl(baseUrl: string, serviceName: string): string;
+/**
+ * Build URL for LLM context endpoint.
+ *
+ * @param baseUrl - Base dinkd URL
+ * @param serviceNames - Optional array of service names to filter
+ * @returns Full URL for /api/llm.txt with optional services query param
+ */
+export declare function buildLLMContextUrl(baseUrl: string, serviceNames?: string[]): string;
+/**
+ * HTTP response from describe endpoint (JSON format).
+ */
+interface DescribeHttpResponse {
+    success: boolean;
+    services?: ServiceDescriptor[];
+    error?: string;
+}
+/**
+ * Parse describe endpoint JSON response into ServiceDescriptor.
+ *
+ * @param response - Raw HTTP response
+ * @returns Parsed ServiceDescriptor
+ * @throws IntrospectError if response indicates failure
+ */
+export declare function parseDescribeResponse(response: DescribeHttpResponse): ServiceDescriptor;
+/**
+ * Parse LLM context response (plain text).
+ *
+ * @param content - Raw text content
+ * @returns The LLM context string
+ */
+export declare function parseLLMContextResponse(content: string): string;
+/**
+ * Describe an edge service by name, returning its ServiceDescriptor.
+ *
+ * Makes an authenticated HTTP GET to dinkd /api/services/:service/llm.txt
+ * with Accept: application/json header to get structured service metadata.
+ *
+ * @param _ctx - Convex action context (unused, for future expansion)
+ * @param serviceName - The name of the service to describe
+ * @returns Promise resolving to the ServiceDescriptor
+ * @throws IntrospectError if configuration is missing, service not found, or request fails
+ *
+ * @example
+ * ```typescript
+ * import { describeEdgeServices } from "@fatagnus/dink-convex";
+ *
+ * export const getServiceInfo = action({
+ *   args: { serviceName: v.string() },
+ *   handler: async (ctx, args) => {
+ *     const descriptor = await describeEdgeServices(ctx, args.serviceName);
+ *     return {
+ *       name: descriptor.name,
+ *       version: descriptor.version,
+ *       methods: descriptor.methods?.map(m => m.name),
+ *     };
+ *   },
+ * });
+ * ```
+ */
+export declare function describeEdgeServices(_ctx: ActionCtx, serviceName: string): Promise<ServiceDescriptor>;
+/**
+ * Get LLM-friendly context (llm.txt format) for edge services.
+ *
+ * Makes an authenticated HTTP GET to dinkd /api/llm.txt to get
+ * human/AI-readable documentation for services.
+ *
+ * @param _ctx - Convex action context (unused, for future expansion)
+ * @param serviceNames - Optional service name(s) to filter. Can be a single string or array.
+ *                       If omitted, returns context for all services.
+ * @returns Promise resolving to llm.txt formatted string
+ * @throws IntrospectError if configuration is missing or request fails
+ *
+ * @example
+ * ```typescript
+ * import { getLLMContext } from "@fatagnus/dink-convex";
+ *
+ * // Get context for all services
+ * export const getAllContext = action({
+ *   handler: async (ctx) => {
+ *     return await getLLMContext(ctx);
+ *   },
+ * });
+ *
+ * // Get context for specific services
+ * export const getSpecificContext = action({
+ *   args: { services: v.array(v.string()) },
+ *   handler: async (ctx, args) => {
+ *     return await getLLMContext(ctx, args.services);
+ *   },
+ * });
+ * ```
+ */
+export declare function getLLMContext(_ctx: ActionCtx, serviceNames?: string | string[]): Promise<string>;
+export {};
+//# sourceMappingURL=introspect.d.ts.map

package/dist/introspect.d.ts.map

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

package/dist/introspect.js

@@ -0,0 +1,244 @@
+/**
+ * Introspection Helpers for Convex
+ *
+ * These helpers allow Convex actions to introspect edge services and get
+ * LLM-friendly context via dinkd HTTP endpoints.
+ *
+ * @module introspect
+ */
+// ============================================================================
+// Error handling
+// ============================================================================
+/**
+ * Error codes for introspection operations.
+ */
+export const INTROSPECT_ERROR_CODES = {
+    /** DINK_URL or DINK_APP_SYNC_KEY not configured */
+    MISSING_CONFIG: "MISSING_CONFIG",
+    /** Network error during HTTP request */
+    NETWORK_ERROR: "NETWORK_ERROR",
+    /** Service not found */
+    NOT_FOUND: "NOT_FOUND",
+    /** Authentication failed */
+    UNAUTHORIZED: "UNAUTHORIZED",
+    /** Server returned an error */
+    SERVER_ERROR: "SERVER_ERROR",
+    /** Invalid input */
+    INVALID_INPUT: "INVALID_INPUT",
+};
+/**
+ * Error type for introspection operations.
+ */
+export class IntrospectError extends Error {
+    /** Error code */
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "IntrospectError";
+        this.code = code;
+    }
+}
+// ============================================================================
+// Configuration
+// ============================================================================
+/**
+ * Get introspection configuration from environment variables.
+ *
+ * @returns Configuration object with dinkUrl and appSyncKey
+ */
+export function getIntrospectConfig() {
+    return {
+        dinkUrl: process.env.DINK_URL,
+        appSyncKey: process.env.DINK_APP_SYNC_KEY,
+    };
+}
+/**
+ * Validate that required configuration is present.
+ *
+ * @throws IntrospectError if configuration is missing
+ */
+function validateConfig() {
+    const config = getIntrospectConfig();
+    if (!config.dinkUrl) {
+        throw new IntrospectError(INTROSPECT_ERROR_CODES.MISSING_CONFIG, "DINK_URL environment variable is not configured");
+    }
+    if (!config.appSyncKey) {
+        throw new IntrospectError(INTROSPECT_ERROR_CODES.MISSING_CONFIG, "DINK_APP_SYNC_KEY environment variable is not configured");
+    }
+    return {
+        dinkUrl: config.dinkUrl,
+        appSyncKey: config.appSyncKey,
+    };
+}
+// ============================================================================
+// URL builders
+// ============================================================================
+/**
+ * Build URL for single service describe endpoint.
+ *
+ * @param baseUrl - Base dinkd URL
+ * @param serviceName - Name of the service to describe
+ * @returns Full URL for /api/services/:service/llm.txt
+ */
+export function buildDescribeUrl(baseUrl, serviceName) {
+    const url = new URL(`/api/services/${serviceName}/llm.txt`, baseUrl);
+    return url.toString();
+}
+/**
+ * Build URL for LLM context endpoint.
+ *
+ * @param baseUrl - Base dinkd URL
+ * @param serviceNames - Optional array of service names to filter
+ * @returns Full URL for /api/llm.txt with optional services query param
+ */
+export function buildLLMContextUrl(baseUrl, serviceNames) {
+    const url = new URL("/api/llm.txt", baseUrl);
+    if (serviceNames && serviceNames.length > 0) {
+        url.searchParams.set("services", serviceNames.join(","));
+    }
+    return url.toString();
+}
+// ============================================================================
+// Response parsers
+// ============================================================================
+/**
+ * Parse describe endpoint JSON response into ServiceDescriptor.
+ *
+ * @param response - Raw HTTP response
+ * @returns Parsed ServiceDescriptor
+ * @throws IntrospectError if response indicates failure
+ */
+export function parseDescribeResponse(response) {
+    if (!response.success) {
+        throw new IntrospectError(INTROSPECT_ERROR_CODES.SERVER_ERROR, response.error || "Unknown server error");
+    }
+    if (!response.services || response.services.length === 0) {
+        throw new IntrospectError(INTROSPECT_ERROR_CODES.NOT_FOUND, "No service descriptor found");
+    }
+    return response.services[0];
+}
+/**
+ * Parse LLM context response (plain text).
+ *
+ * @param content - Raw text content
+ * @returns The LLM context string
+ */
+export function parseLLMContextResponse(content) {
+    return content;
+}
+// ============================================================================
+// Main helper functions
+// ============================================================================
+/**
+ * Describe an edge service by name, returning its ServiceDescriptor.
+ *
+ * Makes an authenticated HTTP GET to dinkd /api/services/:service/llm.txt
+ * with Accept: application/json header to get structured service metadata.
+ *
+ * @param _ctx - Convex action context (unused, for future expansion)
+ * @param serviceName - The name of the service to describe
+ * @returns Promise resolving to the ServiceDescriptor
+ * @throws IntrospectError if configuration is missing, service not found, or request fails
+ *
+ * @example
+ * ```typescript
+ * import { describeEdgeServices } from "@fatagnus/dink-convex";
+ *
+ * export const getServiceInfo = action({
+ *   args: { serviceName: v.string() },
+ *   handler: async (ctx, args) => {
+ *     const descriptor = await describeEdgeServices(ctx, args.serviceName);
+ *     return {
+ *       name: descriptor.name,
+ *       version: descriptor.version,
+ *       methods: descriptor.methods?.map(m => m.name),
+ *     };
+ *   },
+ * });
+ * ```
+ */
+export async function describeEdgeServices(_ctx, serviceName) {
+    const config = validateConfig();
+    if (!serviceName) {
+        throw new IntrospectError(INTROSPECT_ERROR_CODES.INVALID_INPUT, "service name is required");
+    }
+    const url = buildDescribeUrl(config.dinkUrl, serviceName);
+    const response = await fetch(url, {
+        method: "GET",
+        headers: {
+            Accept: "application/json",
+            Authorization: `Bearer ${config.appSyncKey}`,
+        },
+    });
+    if (response.status === 401) {
+        throw new IntrospectError(INTROSPECT_ERROR_CODES.UNAUTHORIZED, "Invalid authorization token");
+    }
+    if (response.status === 404) {
+        throw new IntrospectError(INTROSPECT_ERROR_CODES.NOT_FOUND, `Service not found: ${serviceName}`);
+    }
+    if (!response.ok) {
+        const errorText = await response.text().catch(() => "");
+        throw new IntrospectError(INTROSPECT_ERROR_CODES.SERVER_ERROR, `Server error: ${response.status} ${response.statusText} - ${errorText}`);
+    }
+    const json = (await response.json());
+    return parseDescribeResponse(json);
+}
+/**
+ * Get LLM-friendly context (llm.txt format) for edge services.
+ *
+ * Makes an authenticated HTTP GET to dinkd /api/llm.txt to get
+ * human/AI-readable documentation for services.
+ *
+ * @param _ctx - Convex action context (unused, for future expansion)
+ * @param serviceNames - Optional service name(s) to filter. Can be a single string or array.
+ *                       If omitted, returns context for all services.
+ * @returns Promise resolving to llm.txt formatted string
+ * @throws IntrospectError if configuration is missing or request fails
+ *
+ * @example
+ * ```typescript
+ * import { getLLMContext } from "@fatagnus/dink-convex";
+ *
+ * // Get context for all services
+ * export const getAllContext = action({
+ *   handler: async (ctx) => {
+ *     return await getLLMContext(ctx);
+ *   },
+ * });
+ *
+ * // Get context for specific services
+ * export const getSpecificContext = action({
+ *   args: { services: v.array(v.string()) },
+ *   handler: async (ctx, args) => {
+ *     return await getLLMContext(ctx, args.services);
+ *   },
+ * });
+ * ```
+ */
+export async function getLLMContext(_ctx, serviceNames) {
+    const config = validateConfig();
+    // Normalize serviceNames to array or undefined
+    const names = serviceNames
+        ? Array.isArray(serviceNames)
+            ? serviceNames
+            : [serviceNames]
+        : undefined;
+    const url = buildLLMContextUrl(config.dinkUrl, names);
+    const response = await fetch(url, {
+        method: "GET",
+        headers: {
+            Accept: "text/plain",
+            Authorization: `Bearer ${config.appSyncKey}`,
+        },
+    });
+    if (response.status === 401) {
+        throw new IntrospectError(INTROSPECT_ERROR_CODES.UNAUTHORIZED, "Invalid authorization token");
+    }
+    if (!response.ok) {
+        const errorText = await response.text().catch(() => "");
+        throw new IntrospectError(INTROSPECT_ERROR_CODES.SERVER_ERROR, `Server error: ${response.status} ${response.statusText} - ${errorText}`);
+    }
+    const text = await response.text();
+    return parseLLMContextResponse(text);
+}
+//# sourceMappingURL=introspect.js.map

package/dist/introspect.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fatagnus/dink-convex",
-  "version": "2.0.2",
+  "version": "2.7.0",
   "description": "Dink Convex sync component - bidirectional sync between Convex and edge devices",
   "type": "module",
   "main": "dist/index.js",
@@ -90,11 +90,7 @@
     "convex": "^1.17.0",
     "convex-helpers": "^0.1.0"
   },
-  "peerDependenciesMeta": {
-    "convex-helpers": {
-      "optional": true
-    }
-  },
+
   "engines": {
     "node": ">=18.0.0"
   },