@stacknet/rackutils 0.2.0 → 0.3.1

package/dist/types/index.d.cts

@@ -63,31 +63,88 @@ interface PushResult {
     manifest_cid?: string;
 }
 interface RackSession {
-    /** Whether the session is authenticated */
     authenticated: boolean;
-    /** Resolved user global ID (from API key) */
     userId?: string;
-    /** API key in use */
     apiKey?: string;
-    /** Permission level */
     permission?: 'read' | 'write';
 }
 interface TokenBudget {
-    /** Plan allocation in tokens */
     planAllocation: number;
-    /** Inference tokens used */
     inferenceUsed: number;
-    /** Ledger debits (skill/tensor registration, etc.) */
     ledgerSpent: number;
-    /** Total used */
     totalUsed: number;
-    /** Remaining tokens */
     remaining: number;
-    /** Usage percentage */
     percent: number;
-    /** Whether the plan limit is exceeded */
     exceeded: boolean;
 }
+interface SkillMeta {
+    skill_id: string;
+    name: string;
+    description?: string;
+    creator: string;
+    stack_id?: string;
+    content_type?: string;
+    category?: string;
+    tags?: string[];
+    version?: string;
+    published_at?: string;
+    lode?: {
+        schema?: string;
+        schema_version?: number;
+        fingerprint: string;
+        vein_binary?: string;
+        vein_bytes?: number;
+    };
+    registration?: {
+        total_bytes: number;
+        base_tokens: number;
+        multiplier: number;
+        registration_cost_tokens: number;
+    };
+}
+interface SkillStats {
+    meta: SkillMeta | null;
+    tokenCount: number | null;
+    usageCount: number | null;
+}
+interface TensorMeta {
+    tensor_id: string;
+    name: string;
+    description?: string;
+    creator: string;
+    content_type?: string;
+    category?: string;
+    tags?: string[];
+    version?: string;
+    base_model?: string;
+    format?: string;
+    tensor_filename?: string;
+    tensor_size_bytes?: number;
+    tensor_size_mb?: number;
+    example_filename?: string;
+    training?: {
+        steps?: number;
+        epochs?: number;
+        learning_rate?: string;
+        batch_size?: number;
+        optimizer?: string;
+    };
+    trigger_words?: string[];
+    published_at?: string;
+    lode?: {
+        fingerprint: string;
+    };
+    registration?: {
+        total_bytes: number;
+        total_megabytes: number;
+        multiplier: number;
+        registration_cost_tokens: number;
+    };
+}
+interface TensorStats {
+    meta: TensorMeta | null;
+    sizeMB: number | null;
+}
 interface SkillRegistrationInput {
     name: string;
     description?: string;
@@ -111,16 +168,11 @@ interface TensorRegistrationInput {
     name: string;
     description?: string;
     tensor_filename: string;
-    /** Base64-encoded tensor data (for small files) */
     tensor_data?: string;
-    /** SHA-256 hash of tensor file (for large files — reference mode) */
     tensor_hash?: string;
-    /** Size of tensor file in bytes (for large files — reference mode) */
     tensor_size_bytes?: number;
-    /** Base64-encoded example media */
     example_data?: string;
     example_filename?: string;
-    /** Text-based example files (e.g. prompts.md) */
     example_files?: Array<{
         path: string;
         content: string;
@@ -161,19 +213,50 @@ interface StarInfo {
     starred: boolean;
     repo_id: string;
 }
+interface NetworkStats {
+    repos: number;
+    skills: number;
+    tensors: number;
+    stacks: number;
+    agents: number;
+    stars: number;
+    usages: number;
+    registration_tokens: number;
+    inference_tokens: number;
+    total_tokens: number;
+}
+interface TrendingRepo extends RepoInfo {
+    stars: number;
+    usage: number;
+    score: number;
+}
+interface PaginationInfo {
+    /** Total items across all pages */
+    total: number;
+    /** Items per page */
+    limit: number;
+    /** Whether more items exist beyond this page */
+    has_more: boolean;
+    /** Opaque cursor for fetching the next page (null if no more) */
+    next_cursor: string | null;
+}
+interface PaginatedResult<T> {
+    items: T[];
+    pagination: PaginationInfo;
+}
+interface PaginationParams {
+    /** Max items to return (default 50, max 100) */
+    limit?: number;
+    /** Opaque cursor from a previous response's next_cursor */
+    cursor?: string;
+}
 interface CostEstimate {
-    /** Type of registration */
     type: 'skill' | 'tensor';
-    /** Total bytes of content */
     totalBytes: number;
-    /** Total megabytes (for tensors) */
     totalMegabytes: number;
-    /** Base cost before multiplier */
     baseCost: number;
-    /** Multiplier applied */
     multiplier: number;
-    /** Final registration cost in tokens */
     registrationCostTokens: number;
 }
 
-export type { CostEstimate, DiffEntry, InitResult, PushResult, RackConfig, RackSession, RepoCommit, RepoFile, RepoInfo, RepoTree, SkillRegistrationInput, SkillRegistrationResult, StarInfo, StarResult, TensorRegistrationInput, TensorRegistrationResult, TokenBudget, TreeEntry };
+export type { CostEstimate, DiffEntry, InitResult, NetworkStats, PaginatedResult, PaginationInfo, PaginationParams, PushResult, RackConfig, RackSession, RepoCommit, RepoFile, RepoInfo, RepoTree, SkillMeta, SkillRegistrationInput, SkillRegistrationResult, SkillStats, StarInfo, StarResult, TensorMeta, TensorRegistrationInput, TensorRegistrationResult, TensorStats, TokenBudget, TreeEntry, TrendingRepo };

package/dist/types/index.d.ts

@@ -63,31 +63,88 @@ interface PushResult {
     manifest_cid?: string;
 }
 interface RackSession {
-    /** Whether the session is authenticated */
     authenticated: boolean;
-    /** Resolved user global ID (from API key) */
     userId?: string;
-    /** API key in use */
     apiKey?: string;
-    /** Permission level */
     permission?: 'read' | 'write';
 }
 interface TokenBudget {
-    /** Plan allocation in tokens */
     planAllocation: number;
-    /** Inference tokens used */
     inferenceUsed: number;
-    /** Ledger debits (skill/tensor registration, etc.) */
     ledgerSpent: number;
-    /** Total used */
     totalUsed: number;
-    /** Remaining tokens */
     remaining: number;
-    /** Usage percentage */
     percent: number;
-    /** Whether the plan limit is exceeded */
     exceeded: boolean;
 }
+interface SkillMeta {
+    skill_id: string;
+    name: string;
+    description?: string;
+    creator: string;
+    stack_id?: string;
+    content_type?: string;
+    category?: string;
+    tags?: string[];
+    version?: string;
+    published_at?: string;
+    lode?: {
+        schema?: string;
+        schema_version?: number;
+        fingerprint: string;
+        vein_binary?: string;
+        vein_bytes?: number;
+    };
+    registration?: {
+        total_bytes: number;
+        base_tokens: number;
+        multiplier: number;
+        registration_cost_tokens: number;
+    };
+}
+interface SkillStats {
+    meta: SkillMeta | null;
+    tokenCount: number | null;
+    usageCount: number | null;
+}
+interface TensorMeta {
+    tensor_id: string;
+    name: string;
+    description?: string;
+    creator: string;
+    content_type?: string;
+    category?: string;
+    tags?: string[];
+    version?: string;
+    base_model?: string;
+    format?: string;
+    tensor_filename?: string;
+    tensor_size_bytes?: number;
+    tensor_size_mb?: number;
+    example_filename?: string;
+    training?: {
+        steps?: number;
+        epochs?: number;
+        learning_rate?: string;
+        batch_size?: number;
+        optimizer?: string;
+    };
+    trigger_words?: string[];
+    published_at?: string;
+    lode?: {
+        fingerprint: string;
+    };
+    registration?: {
+        total_bytes: number;
+        total_megabytes: number;
+        multiplier: number;
+        registration_cost_tokens: number;
+    };
+}
+interface TensorStats {
+    meta: TensorMeta | null;
+    sizeMB: number | null;
+}
 interface SkillRegistrationInput {
     name: string;
     description?: string;
@@ -111,16 +168,11 @@ interface TensorRegistrationInput {
     name: string;
     description?: string;
     tensor_filename: string;
-    /** Base64-encoded tensor data (for small files) */
     tensor_data?: string;
-    /** SHA-256 hash of tensor file (for large files — reference mode) */
     tensor_hash?: string;
-    /** Size of tensor file in bytes (for large files — reference mode) */
     tensor_size_bytes?: number;
-    /** Base64-encoded example media */
     example_data?: string;
     example_filename?: string;
-    /** Text-based example files (e.g. prompts.md) */
     example_files?: Array<{
         path: string;
         content: string;
@@ -161,19 +213,50 @@ interface StarInfo {
     starred: boolean;
     repo_id: string;
 }
+interface NetworkStats {
+    repos: number;
+    skills: number;
+    tensors: number;
+    stacks: number;
+    agents: number;
+    stars: number;
+    usages: number;
+    registration_tokens: number;
+    inference_tokens: number;
+    total_tokens: number;
+}
+interface TrendingRepo extends RepoInfo {
+    stars: number;
+    usage: number;
+    score: number;
+}
+interface PaginationInfo {
+    /** Total items across all pages */
+    total: number;
+    /** Items per page */
+    limit: number;
+    /** Whether more items exist beyond this page */
+    has_more: boolean;
+    /** Opaque cursor for fetching the next page (null if no more) */
+    next_cursor: string | null;
+}
+interface PaginatedResult<T> {
+    items: T[];
+    pagination: PaginationInfo;
+}
+interface PaginationParams {
+    /** Max items to return (default 50, max 100) */
+    limit?: number;
+    /** Opaque cursor from a previous response's next_cursor */
+    cursor?: string;
+}
 interface CostEstimate {
-    /** Type of registration */
     type: 'skill' | 'tensor';
-    /** Total bytes of content */
     totalBytes: number;
-    /** Total megabytes (for tensors) */
     totalMegabytes: number;
-    /** Base cost before multiplier */
     baseCost: number;
-    /** Multiplier applied */
     multiplier: number;
-    /** Final registration cost in tokens */
     registrationCostTokens: number;
 }
 
-export type { CostEstimate, DiffEntry, InitResult, PushResult, RackConfig, RackSession, RepoCommit, RepoFile, RepoInfo, RepoTree, SkillRegistrationInput, SkillRegistrationResult, StarInfo, StarResult, TensorRegistrationInput, TensorRegistrationResult, TokenBudget, TreeEntry };
+export type { CostEstimate, DiffEntry, InitResult, NetworkStats, PaginatedResult, PaginationInfo, PaginationParams, PushResult, RackConfig, RackSession, RepoCommit, RepoFile, RepoInfo, RepoTree, SkillMeta, SkillRegistrationInput, SkillRegistrationResult, SkillStats, StarInfo, StarResult, TensorMeta, TensorRegistrationInput, TensorRegistrationResult, TensorStats, TokenBudget, TreeEntry, TrendingRepo };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stacknet/rackutils",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "React hooks and components for reading and writing StackNet Racks",
   "type": "module",
   "main": "./dist/index.cjs",