@standardagents/builder 0.11.12 → 0.12.1

package/dist/discovery-CpMs68Yx.d.ts

@@ -0,0 +1,97 @@
+import { D as DiscoveredPackage } from './types-pLkJx8vg.js';
+import { PackageSignature } from '@standardagents/spec';
+
+/**
+ * Package discovery service for Standard Agents.
+ *
+ * Discovers packed agent packages from:
+ * - npm packages (by keyword, naming convention, or standardagent field)
+ * - Local agents/packed/ directory
+ *
+ * Packages are detected by checking for the `standardagent` field in
+ * package.json, not by looking for manifest.json.
+ *
+ * @module
+ */
+
+/**
+ * Configuration for package discovery.
+ */
+interface DiscoveryConfig {
+    /** Root directory of the project */
+    rootDir: string;
+    /** Directory for local packed agents (default: agents/packed) */
+    packedDir?: string;
+    /** Whether to scan npm packages (default: true) */
+    scanNpm?: boolean;
+    /** Whether to scan local packed directory (default: true) */
+    scanLocal?: boolean;
+}
+/**
+ * Service for discovering packed agent packages.
+ */
+declare class PackageDiscoveryService {
+    private config;
+    constructor(config: DiscoveryConfig);
+    /**
+     * Discover all packed agent packages.
+     *
+     * @returns Array of discovered packages
+     */
+    discoverPackages(): Promise<DiscoveredPackage[]>;
+    /**
+     * Discover npm packages that are Standard Agents packages.
+     *
+     * Looks for packages with:
+     * - "standardagent" keyword in package.json
+     * - "standardagent-*" prefix in name
+     * - "@standardagents/*" scope
+     * - "standardagent" field in package.json
+     */
+    private discoverNpmPackages;
+    /**
+     * Check if an npm package is a Standard Agent package.
+     *
+     * Detection is based on the `standardagent` field in package.json,
+     * which must contain `entryAgents` array.
+     */
+    private checkNpmPackage;
+    /**
+     * Discover local packed agents from agents/packed/ directory.
+     * Handles both regular packages and scoped packages (@scope/name).
+     */
+    private discoverLocalPackages;
+    /**
+     * Check if a local directory is a packed agent package.
+     *
+     * Detection is based on the `standardagent` field in package.json.
+     */
+    private checkLocalPackage;
+    /**
+     * Scan a directory and return entry names.
+     */
+    private scanDirectory;
+    /**
+     * Validate a standardagent field structure in package.json.
+     */
+    static validateStandardAgentField(field: unknown): field is {
+        entryAgents: string[];
+    };
+    /**
+     * Get a package by ID.
+     */
+    getPackage(packageId: string): Promise<DiscoveredPackage | null>;
+    /**
+     * Create a package signature from a discovered package.
+     *
+     * Note: packedAt is set to current time since it's no longer
+     * stored in a manifest file.
+     */
+    static createSignature(pkg: DiscoveredPackage): PackageSignature;
+}
+/**
+ * Convenience function to discover all packages.
+ */
+declare function discoverPackages(rootDir: string): Promise<DiscoveredPackage[]>;
+
+export { type DiscoveryConfig as D, PackageDiscoveryService as P, discoverPackages as d };