@fatagnus/dink-sdk 2.1.0 → 2.4.0

package/dist/introspect.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Service introspection types for AI agent support.
+ * These types match the Go struct definitions in pkg/types/introspect.go
+ * Property names use snake_case to match Go JSON tags for wire compatibility.
+ */
+/**
+ * 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 for introspection
+ * and AI agent consumption.
+ */
+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 for introspection
+ * and AI agent consumption.
+ */
+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[];
+}
+//# 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":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,2CAA2C;IAC3C,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B"}

package/dist/introspect.js

@@ -0,0 +1,7 @@
+/**
+ * Service introspection types for AI agent support.
+ * These types match the Go struct definitions in pkg/types/introspect.go
+ * Property names use snake_case to match Go JSON tags for wire compatibility.
+ */
+export {};
+//# sourceMappingURL=introspect.js.map

package/dist/introspect.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fatagnus/dink-sdk",
-  "version": "2.1.0",
+  "version": "2.4.0",
   "description": "TypeScript SDK for Dink edge mesh platform",
   "type": "module",
   "main": "dist/index.js",