@pikku/inspector 0.11.0 → 0.11.2

package/src/utils/post-process.ts

@@ -1,3 +1,4 @@
+import * as ts from 'typescript'
 import { InspectorState } from '../types.js'
 import {
   FunctionServicesMeta,
@@ -5,6 +6,10 @@ import {
   PermissionMetadata,
 } from '@pikku/core'
 import { extractTypeKeys } from './type-utils.js'
+import {
+  extractAllServiceMetadata,
+  ServiceMetadata,
+} from './extract-service-metadata.js'
 
 /**
  * Helper to extract wire-level middleware/permission names from metadata.
@@ -82,9 +87,9 @@ function extractAllServices(
   const servicesTypes = state.typesLookup.get('Services')
   if (servicesTypes && servicesTypes.length > 0) {
     const allServiceNames = extractTypeKeys(servicesTypes[0])
-    // Session services are those in Services but not in SingletonServices
+    // Wire services are those in Services but not in SingletonServices
     const singletonSet = new Set(state.serviceAggregation.allSingletonServices)
-    state.serviceAggregation.allSessionServices = allServiceNames
+    state.serviceAggregation.allWireServices = allServiceNames
       .filter((name) => !singletonSet.has(name))
       .sort()
   }
@@ -206,7 +211,7 @@ export function aggregateRequiredServices(
   }
 
   // 5. Services from session service factories
-  for (const singletonServices of state.sessionServicesMeta.values()) {
+  for (const singletonServices of state.wireServicesMeta.values()) {
     singletonServices.forEach((service) => {
       if (!internalServices.has(service)) {
         requiredServices.add(service)
@@ -214,3 +219,51 @@ export function aggregateRequiredServices(
     })
   }
 }
+
+/**
+ * Extract service interface metadata for all user-defined services.
+ * This extracts metadata for services in SingletonServices and Services types
+ * to generate documentation for AI consumption.
+ *
+ * Must be called after aggregateRequiredServices() to ensure types are loaded.
+ */
+export function extractServiceInterfaceMetadata(
+  state: InspectorState | Omit<InspectorState, 'typesLookup'>,
+  checker: ts.TypeChecker
+): void {
+  if (!('typesLookup' in state)) {
+    return
+  }
+
+  const allMetadata: ServiceMetadata[] = []
+
+  const singletonServicesTypes = state.typesLookup.get('SingletonServices')
+  if (singletonServicesTypes && singletonServicesTypes.length > 0) {
+    const singletonMeta = extractAllServiceMetadata(
+      singletonServicesTypes[0],
+      checker,
+      state.rootDir
+    )
+    allMetadata.push(...singletonMeta)
+  }
+
+  const servicesTypes = state.typesLookup.get('Services')
+  if (servicesTypes && servicesTypes.length > 0) {
+    const wireServicesMeta = extractAllServiceMetadata(
+      servicesTypes[0],
+      checker,
+      state.rootDir
+    )
+
+    const singletonNames = new Set(
+      state.serviceAggregation.allSingletonServices
+    )
+    const uniqueWireServices = wireServicesMeta.filter(
+      (meta) => !singletonNames.has(meta.name)
+    )
+
+    allMetadata.push(...uniqueWireServices)
+  }
+
+  state.serviceMetadata = allMetadata
+}

package/src/utils/serialize-inspector-state.ts

@@ -13,7 +13,7 @@ export interface SerializableInspectorState {
       { variable: string; type: string | null; typePath: string | null }[],
     ]
   >
-  sessionServicesTypeImportMap: Array<
+  wireServicesTypeImportMap: Array<
     [
       string,
       { variable: string; type: string | null; typePath: string | null }[],
@@ -37,13 +37,13 @@ export interface SerializableInspectorState {
       { variable: string; type: string | null; typePath: string | null }[],
     ]
   >
-  sessionServicesFactories: Array<
+  wireServicesFactories: Array<
     [
       string,
       { variable: string; type: string | null; typePath: string | null }[],
     ]
   >
-  sessionServicesMeta: Array<[string, string[]]>
+  wireServicesMeta: Array<[string, string[]]>
   configFactories: Array<
     [
       string,
@@ -62,6 +62,7 @@ export interface SerializableInspectorState {
       >,
     ]
   >
+  zodLookup: Array<[string, { variableName: string; sourceFile: string }]>
   functions: {
     typesMap: {
       map: Array<[string, { originalName: string; path: string | null }]>
@@ -114,7 +115,9 @@ export interface SerializableInspectorState {
   }
   workflows: {
     meta: InspectorState['workflows']['meta']
-    files: string[]
+    files: Array<[string, { path: string; exportedName: string }]>
+    graphMeta: InspectorState['workflows']['graphMeta']
+    graphFiles: Array<[string, { path: string; exportedName: string }]>
   }
   rpc: {
     internalMeta: InspectorState['rpc']['internalMeta']
@@ -122,6 +125,7 @@ export interface SerializableInspectorState {
     exposedMeta: InspectorState['rpc']['exposedMeta']
     exposedFiles: Array<[string, { path: string; exportedName: string }]>
     invokedFunctions: string[]
+    usedExternalPackages: string[]
   }
   mcpEndpoints: {
     resourcesMeta: InspectorState['mcpEndpoints']['resourcesMeta']
@@ -133,6 +137,14 @@ export interface SerializableInspectorState {
     meta: InspectorState['cli']['meta']
     files: string[]
   }
+  forgeNodes: {
+    meta: InspectorState['forgeNodes']['meta']
+    files: string[]
+  }
+  forgeCredentials: {
+    meta: InspectorState['forgeCredentials']['meta']
+    files: string[]
+  }
   middleware: {
     meta: InspectorState['middleware']['meta']
     tagMiddleware: Array<
@@ -167,8 +179,18 @@ export interface SerializableInspectorState {
     usedMiddleware: string[]
     usedPermissions: string[]
     allSingletonServices: string[]
-    allSessionServices: string[]
+    allWireServices: string[]
   }
+  serviceMetadata: Array<{
+    name: string
+    summary: string
+    description: string
+    package: string
+    path: string
+    version: string
+    interface: string
+    expandedProperties: Record<string, string>
+  }>
 }
 
 /**
@@ -204,8 +226,8 @@ export function serializeInspectorState(
     singletonServicesTypeImportMap: Array.from(
       state.singletonServicesTypeImportMap.entries()
     ),
-    sessionServicesTypeImportMap: Array.from(
-      state.sessionServicesTypeImportMap.entries()
+    wireServicesTypeImportMap: Array.from(
+      state.wireServicesTypeImportMap.entries()
     ),
     userSessionTypeImportMap: Array.from(
       state.userSessionTypeImportMap.entries()
@@ -214,15 +236,14 @@ export function serializeInspectorState(
     singletonServicesFactories: Array.from(
       state.singletonServicesFactories.entries()
     ),
-    sessionServicesFactories: Array.from(
-      state.sessionServicesFactories.entries()
-    ),
-    sessionServicesMeta: Array.from(state.sessionServicesMeta.entries()),
+    wireServicesFactories: Array.from(state.wireServicesFactories.entries()),
+    wireServicesMeta: Array.from(state.wireServicesMeta.entries()),
     configFactories: Array.from(state.configFactories.entries()),
     filesAndMethods: state.filesAndMethods,
     filesAndMethodsErrors: Array.from(
       state.filesAndMethodsErrors.entries()
     ).map(([key, mapValue]) => [key, Array.from(mapValue.entries())] as const),
+    zodLookup: Array.from(state.zodLookup.entries()),
     functions: {
       typesMap: serializeTypesMap(state.functions.typesMap),
       meta: state.functions.meta,
@@ -249,7 +270,9 @@ export function serializeInspectorState(
     },
     workflows: {
       meta: state.workflows.meta,
-      files: Array.from(state.workflows.files),
+      files: Array.from(state.workflows.files.entries()),
+      graphMeta: state.workflows.graphMeta,
+      graphFiles: Array.from(state.workflows.graphFiles.entries()),
     },
     rpc: {
       internalMeta: state.rpc.internalMeta,
@@ -257,6 +280,7 @@ export function serializeInspectorState(
       exposedMeta: state.rpc.exposedMeta,
       exposedFiles: Array.from(state.rpc.exposedFiles.entries()),
       invokedFunctions: Array.from(state.rpc.invokedFunctions),
+      usedExternalPackages: Array.from(state.rpc.usedExternalPackages),
     },
     mcpEndpoints: {
       resourcesMeta: state.mcpEndpoints.resourcesMeta,
@@ -268,6 +292,14 @@ export function serializeInspectorState(
       meta: state.cli.meta,
       files: Array.from(state.cli.files),
     },
+    forgeNodes: {
+      meta: state.forgeNodes.meta,
+      files: Array.from(state.forgeNodes.files),
+    },
+    forgeCredentials: {
+      meta: state.forgeCredentials.meta,
+      files: Array.from(state.forgeCredentials.files),
+    },
     middleware: {
       meta: state.middleware.meta,
       tagMiddleware: Array.from(state.middleware.tagMiddleware.entries()),
@@ -282,8 +314,9 @@ export function serializeInspectorState(
       usedMiddleware: Array.from(state.serviceAggregation.usedMiddleware),
       usedPermissions: Array.from(state.serviceAggregation.usedPermissions),
       allSingletonServices: state.serviceAggregation.allSingletonServices,
-      allSessionServices: state.serviceAggregation.allSessionServices,
+      allWireServices: state.serviceAggregation.allWireServices,
     },
+    serviceMetadata: state.serviceMetadata,
   }
 }
 
@@ -293,7 +326,9 @@ export function serializeInspectorState(
  */
 export function deserializeInspectorState(
   data: SerializableInspectorState
-): Omit<InspectorState, 'typesLookup'> {
+): Omit<InspectorState, 'typesLookup' | 'zodLookup'> & {
+  zodLookup: Map<string, { variableName: string; sourceFile: string }>
+} {
   // Helper to deserialize TypesMap
   const deserializeTypesMap = (
     serialized: SerializableInspectorState['functions']['typesMap']
@@ -314,12 +349,12 @@ export function deserializeInspectorState(
     singletonServicesTypeImportMap: new Map(
       data.singletonServicesTypeImportMap
     ),
-    sessionServicesTypeImportMap: new Map(data.sessionServicesTypeImportMap),
+    wireServicesTypeImportMap: new Map(data.wireServicesTypeImportMap),
     userSessionTypeImportMap: new Map(data.userSessionTypeImportMap),
     configTypeImportMap: new Map(data.configTypeImportMap),
     singletonServicesFactories: new Map(data.singletonServicesFactories),
-    sessionServicesFactories: new Map(data.sessionServicesFactories),
-    sessionServicesMeta: new Map(data.sessionServicesMeta),
+    wireServicesFactories: new Map(data.wireServicesFactories),
+    wireServicesMeta: new Map(data.wireServicesMeta),
     configFactories: new Map(data.configFactories),
     filesAndMethods: data.filesAndMethods,
     filesAndMethodsErrors: new Map(
@@ -328,6 +363,7 @@ export function deserializeInspectorState(
         new Map(entries),
       ])
     ),
+    zodLookup: new Map(data.zodLookup || []),
     functions: {
       typesMap: deserializeTypesMap(data.functions.typesMap),
       meta: data.functions.meta,
@@ -354,7 +390,9 @@ export function deserializeInspectorState(
     },
     workflows: {
       meta: data.workflows.meta,
-      files: new Set(data.workflows.files),
+      files: new Map(data.workflows.files),
+      graphMeta: data.workflows.graphMeta || {},
+      graphFiles: new Map(data.workflows.graphFiles || []),
     },
     rpc: {
       internalMeta: data.rpc.internalMeta,
@@ -362,6 +400,7 @@ export function deserializeInspectorState(
       exposedMeta: data.rpc.exposedMeta,
       exposedFiles: new Map(data.rpc.exposedFiles),
       invokedFunctions: new Set(data.rpc.invokedFunctions),
+      usedExternalPackages: new Set(data.rpc.usedExternalPackages || []),
     },
     mcpEndpoints: {
       resourcesMeta: data.mcpEndpoints.resourcesMeta,
@@ -373,6 +412,14 @@ export function deserializeInspectorState(
       meta: data.cli.meta,
       files: new Set(data.cli.files),
     },
+    forgeNodes: {
+      meta: data.forgeNodes?.meta || {},
+      files: new Set(data.forgeNodes?.files || []),
+    },
+    forgeCredentials: {
+      meta: data.forgeCredentials?.meta || {},
+      files: new Set(data.forgeCredentials?.files || []),
+    },
     middleware: {
       meta: data.middleware.meta,
       tagMiddleware: new Map(data.middleware.tagMiddleware),
@@ -387,7 +434,8 @@ export function deserializeInspectorState(
       usedMiddleware: new Set(data.serviceAggregation.usedMiddleware),
       usedPermissions: new Set(data.serviceAggregation.usedPermissions),
       allSingletonServices: data.serviceAggregation.allSingletonServices,
-      allSessionServices: data.serviceAggregation.allSessionServices,
+      allWireServices: data.serviceAggregation.allWireServices,
     },
+    serviceMetadata: data.serviceMetadata || [],
   }
 }

package/src/utils/test-data/inspector-state.json

@@ -12,7 +12,7 @@
       ]
     ]
   ],
-  "sessionServicesTypeImportMap": [
+  "wireServicesTypeImportMap": [
     [
       "/Users/yasser/git/pikku/pikku/templates/functions/types/application-types.d.ts",
       [
@@ -60,19 +60,19 @@
       ]
     ]
   ],
-  "sessionServicesFactories": [
+  "wireServicesFactories": [
     [
       "src/services.ts",
       [
         {
-          "variable": "createSessionServices",
-          "type": "CreateSessionServices",
+          "variable": "createWireServices",
+          "type": "CreateWireServices",
           "typePath": "src/services.ts"
         }
       ]
     ]
   ],
-  "sessionServicesMeta": [["createSessionServices", []]],
+  "wireServicesMeta": [["createWireServices", []]],
   "configFactories": [
     [
       "src/services.ts",
@@ -98,7 +98,7 @@
       "variable": "SingletonServices",
       "typePath": "/Users/yasser/git/pikku/pikku/templates/functions/types/application-types.d.ts"
     },
-    "sessionServicesType": {
+    "wireServicesType": {
       "file": "/Users/yasser/git/pikku/pikku/templates/functions/types/application-types.d.ts",
       "type": "Services",
       "variable": "Services",
@@ -122,10 +122,10 @@
       "variable": "createSingletonServices",
       "typePath": "src/services.ts"
     },
-    "sessionServicesFactory": {
+    "wireServicesFactory": {
       "file": "src/services.ts",
-      "type": "CreateSessionServices",
-      "variable": "createSessionServices",
+      "type": "CreateWireServices",
+      "variable": "createWireServices",
       "typePath": "src/services.ts"
     }
   },