@aigne/afs-registry 1.11.0-beta.7 → 1.11.0-beta.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -1,25 +1,31 @@
1
- import { AFSBaseProvider, AFSEntry, AFSExecResult, AFSExplainResult, AFSRoot, AFSSearchResult, AFSStatResult, RouteContext } from "@aigne/afs";
1
+ import { AFSBaseProvider, AFSEntry, AFSExecResult, AFSExplainOptions, AFSExplainResult, AFSListOptions, AFSListResult, AFSReadOptions, AFSReadResult, AFSRoot, AFSSearchOptions, AFSSearchResult, AFSStatOptions, AFSStatResult, RouteContext } from "@aigne/afs";
2
2
 
3
3
  //#region src/index.d.ts
4
4
  /**
5
5
  * A single provider manifest entry in the registry.
6
+ *
7
+ * Aligned with the core ProviderManifest (serialized form: schema as JSON Schema
8
+ * instead of Zod, camelCase field names).
6
9
  */
7
10
  interface ProviderManifest {
8
11
  name: string;
9
12
  description: string;
10
13
  category: string;
11
- scheme: string;
12
- capabilities_summary: string;
14
+ /** URI template with {param} placeholders, e.g. "s3://{bucket}/{prefix+?}" */
15
+ uriTemplate: string;
16
+ /** JSON Schema describing provider parameters (serialized from Zod) */
17
+ schema?: Record<string, unknown>;
13
18
  tags?: string[];
14
- use_cases?: string[];
15
- package?: string;
19
+ useCases?: string[];
16
20
  }
17
21
  /**
18
22
  * Options for constructing an AFSRegistry provider.
19
23
  */
20
24
  interface AFSRegistryOptions {
21
- /** Static list of provider manifests (for testing / offline use) */
22
- providers: ProviderManifest[];
25
+ /** Static provider manifests (for testing / offline use). Overrides url if provided. */
26
+ providers?: ProviderManifest[];
27
+ /** Remote URL to fetch provider manifests from. Falls back to bundled data on failure. */
28
+ url?: string;
23
29
  }
24
30
  /**
25
31
  * AFS Registry Provider — virtual file tree for discovering and mounting providers.
@@ -40,11 +46,21 @@ declare class AFSRegistry extends AFSBaseProvider {
40
46
  readonly description = "AFS Provider Registry \u2014 discover and mount providers";
41
47
  readonly accessMode: "readwrite";
42
48
  private providers;
49
+ private remoteUrl?;
50
+ private fetchPromise?;
43
51
  private loadProviderFn?;
44
- constructor(options: AFSRegistryOptions);
52
+ constructor(options?: AFSRegistryOptions);
53
+ private fetchRemoteProviders;
54
+ private ensureLoaded;
45
55
  onMount(root: AFSRoot): void;
46
- private get byCategory();
47
- private get byTag();
56
+ list(path: string, options?: AFSListOptions): Promise<AFSListResult>;
57
+ read(path: string, options?: AFSReadOptions): Promise<AFSReadResult>;
58
+ stat(path: string, options?: AFSStatOptions): Promise<AFSStatResult>;
59
+ search(path: string, query: string, options?: AFSSearchOptions): Promise<AFSSearchResult>;
60
+ exec(path: string, args: Record<string, unknown>, options: Record<string, unknown>): Promise<AFSExecResult>;
61
+ explain(path: string, options?: AFSExplainOptions): Promise<AFSExplainResult>;
62
+ private buildByCategory;
63
+ private buildByTag;
48
64
  private findProvider;
49
65
  listRoot(_ctx: RouteContext): Promise<{
50
66
  data: AFSEntry[];
@@ -149,11 +165,18 @@ declare class AFSRegistry extends AFSBaseProvider {
149
165
  data: AFSEntry[];
150
166
  }>;
151
167
  searchProviders(_ctx: RouteContext, args: Record<string, unknown>): Promise<AFSExecResult>;
168
+ /**
169
+ * Build mount action inputSchema for a provider
170
+ */
171
+ private buildMountSchema;
152
172
  listProviderActions(ctx: RouteContext<{
153
173
  name: string;
154
174
  }>): Promise<{
155
175
  data: AFSEntry[];
156
176
  }>;
177
+ readMountAction(ctx: RouteContext<{
178
+ name: string;
179
+ }>): Promise<AFSEntry | undefined>;
157
180
  mountProvider(ctx: RouteContext<{
158
181
  name: string;
159
182
  }>, args: Record<string, unknown>): Promise<AFSExecResult>;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":"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"}
1
+ {"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":"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"}