@resourcexjs/arp 1.6.0 → 1.7.0

package/dist/index.d.ts

@@ -408,6 +408,67 @@ declare class HttpTransportHandler implements TransportHandler {
 }
 declare const httpsTransport: HttpTransportHandler;
 declare const httpTransport: HttpTransportHandler;
+/**
+* Minimal registry interface required by RxrTransport.
+* This allows RxrTransport to work without depending on the full Registry type.
+*/
+interface RxrTransportRegistry {
+	get(locator: string): Promise<{
+		content: {
+			files(): Promise<Map<string, Buffer>>
+		}
+	}>;
+}
+/**
+* RXR Transport - Access files inside a resource.
+*
+* Location format: {rxl}/{internal-path}
+* Example: deepractice.ai/nuwa.role@1.0.0/thought/first-principles.md
+*
+* The RXL portion ends at @version, and the internal path follows.
+*
+* When no registry is provided, automatically creates one based on domain:
+* - localhost: LocalRegistry
+* - Other domains: RemoteRegistry with well-known discovery
+*/
+declare class RxrTransport implements TransportHandler {
+	private registry?;
+	readonly name = "rxr";
+	constructor(registry?: RxrTransportRegistry);
+	/**
+	* Get file content from inside a resource.
+	*/
+	get(location: string, _params?: TransportParams): Promise<TransportResult>;
+	/**
+	* Set is not supported - RXR transport is read-only.
+	*/
+	set(_location: string, _content: Buffer, _params?: TransportParams): Promise<void>;
+	/**
+	* Check if a file exists inside a resource.
+	*/
+	exists(location: string): Promise<boolean>;
+	/**
+	* Delete is not supported - RXR transport is read-only.
+	*/
+	delete(_location: string): Promise<void>;
+	/**
+	* Get or create a registry for the given domain.
+	* - If a registry was provided in constructor, use it
+	* - localhost: create LocalRegistry
+	* - Other domains: discover endpoint via well-known and create RemoteRegistry
+	*/
+	private getRegistry;
+	/**
+	* Parse location into domain, RXL and internal path.
+	* Format: {domain}/{path}/{name}.{type}@{version}/{internal-path}
+	* Example: deepractice.ai/nuwa.role@1.0.0/thought/first-principles.md
+	*/
+	private parseLocation;
+}
+/**
+* Clear the registry cache. Useful for testing.
+*/
+declare function clearRegistryCache(): void;
 interface TextResource extends Resource<string> {
 	type: "text";
 	content: string;
@@ -437,4 +498,4 @@ declare class BinarySemanticHandler implements SemanticHandler<Buffer> {
 }
 declare const binarySemantic: BinarySemanticHandler;
 declare const VERSION: string;
-export { textSemantic, httpsTransport, httpTransport, fileTransport, createARP, binarySemantic, VERSION, TransportResult, TransportParams, TransportHandler, TransportError, TextSemanticHandler, TextResource, SemanticHandler, SemanticError, SemanticContext, ResourceMeta, Resource, ParseError, HttpTransportHandler, FileTransportHandler, BinarySemanticHandler, BinaryResource, BinaryInput, ARPError, ARPConfig, ARP, ARL, ARI };
+export { textSemantic, httpsTransport, httpTransport, fileTransport, createARP, clearRegistryCache, binarySemantic, VERSION, TransportResult, TransportParams, TransportHandler, TransportError, TextSemanticHandler, TextResource, SemanticHandler, SemanticError, SemanticContext, RxrTransportRegistry, RxrTransport, ResourceMeta, Resource, ParseError, HttpTransportHandler, FileTransportHandler, BinarySemanticHandler, BinaryResource, BinaryInput, ARPError, ARPConfig, ARP, ARL, ARI };