@stacknet/rackutils 0.1.0 → 0.3.0

package/dist/types/index.d.cts

@@ -44,6 +44,10 @@ interface RackConfig {
     ownerMid?: string;
     /** Author MID for write operations */
     authorMid?: string;
+    /** StackNet API key (gk_ or sk_ prefixed) for authenticated operations */
+    apiKey?: string;
+    /** Direct StackNet API URL (for registration/billing — bypasses proxy) */
+    stacknetUrl?: string;
 }
 interface InitResult {
     success: boolean;
@@ -58,5 +62,181 @@ interface PushResult {
     tree_cid: string;
     manifest_cid?: string;
 }
+interface RackSession {
+    authenticated: boolean;
+    userId?: string;
+    apiKey?: string;
+    permission?: 'read' | 'write';
+}
+interface TokenBudget {
+    planAllocation: number;
+    inferenceUsed: number;
+    ledgerSpent: number;
+    totalUsed: number;
+    remaining: number;
+    percent: number;
+    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;
+    skill_md: string;
+    content_type?: string;
+    category?: string;
+    tags?: string[];
+    version?: string;
+    scripts?: string;
+    stack_id?: string;
+}
+interface SkillRegistrationResult {
+    skill_id: string;
+    rack_repo_id: string | null;
+    rack_pinned: boolean;
+    attributed_to: string;
+    registration_cost_tokens: number | null;
+    lode_fingerprint: string | null;
+}
+interface TensorRegistrationInput {
+    name: string;
+    description?: string;
+    tensor_filename: string;
+    tensor_data?: string;
+    tensor_hash?: string;
+    tensor_size_bytes?: number;
+    example_data?: string;
+    example_filename?: string;
+    example_files?: Array<{
+        path: string;
+        content: string;
+    }>;
+    content_type?: string;
+    category?: string;
+    tags?: string[];
+    version?: string;
+    base_model?: string;
+    format?: string;
+    training?: {
+        steps?: number;
+        epochs?: number;
+        learning_rate?: string;
+        batch_size?: number;
+        optimizer?: string;
+    };
+    trigger_words?: string[];
+}
+interface TensorRegistrationResult {
+    tensor_id: string;
+    rack_repo_id: string | null;
+    rack_pinned: boolean;
+    attributed_to: string;
+    registration_cost_tokens: number | null;
+    tensor_size_mb: number | null;
+    lode_fingerprint: string | null;
+}
+interface StarResult {
+    success: boolean;
+    starred: boolean;
+    stars: number;
+    cost: number;
+    transaction_id?: string;
+}
+interface StarInfo {
+    stars: number;
+    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 CostEstimate {
+    type: 'skill' | 'tensor';
+    totalBytes: number;
+    totalMegabytes: number;
+    baseCost: number;
+    multiplier: number;
+    registrationCostTokens: number;
+}
 
-export type { DiffEntry, InitResult, PushResult, RackConfig, RepoCommit, RepoFile, RepoInfo, RepoTree, TreeEntry };
+export type { CostEstimate, DiffEntry, InitResult, NetworkStats, 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

@@ -44,6 +44,10 @@ interface RackConfig {
     ownerMid?: string;
     /** Author MID for write operations */
     authorMid?: string;
+    /** StackNet API key (gk_ or sk_ prefixed) for authenticated operations */
+    apiKey?: string;
+    /** Direct StackNet API URL (for registration/billing — bypasses proxy) */
+    stacknetUrl?: string;
 }
 interface InitResult {
     success: boolean;
@@ -58,5 +62,181 @@ interface PushResult {
     tree_cid: string;
     manifest_cid?: string;
 }
+interface RackSession {
+    authenticated: boolean;
+    userId?: string;
+    apiKey?: string;
+    permission?: 'read' | 'write';
+}
+interface TokenBudget {
+    planAllocation: number;
+    inferenceUsed: number;
+    ledgerSpent: number;
+    totalUsed: number;
+    remaining: number;
+    percent: number;
+    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;
+    skill_md: string;
+    content_type?: string;
+    category?: string;
+    tags?: string[];
+    version?: string;
+    scripts?: string;
+    stack_id?: string;
+}
+interface SkillRegistrationResult {
+    skill_id: string;
+    rack_repo_id: string | null;
+    rack_pinned: boolean;
+    attributed_to: string;
+    registration_cost_tokens: number | null;
+    lode_fingerprint: string | null;
+}
+interface TensorRegistrationInput {
+    name: string;
+    description?: string;
+    tensor_filename: string;
+    tensor_data?: string;
+    tensor_hash?: string;
+    tensor_size_bytes?: number;
+    example_data?: string;
+    example_filename?: string;
+    example_files?: Array<{
+        path: string;
+        content: string;
+    }>;
+    content_type?: string;
+    category?: string;
+    tags?: string[];
+    version?: string;
+    base_model?: string;
+    format?: string;
+    training?: {
+        steps?: number;
+        epochs?: number;
+        learning_rate?: string;
+        batch_size?: number;
+        optimizer?: string;
+    };
+    trigger_words?: string[];
+}
+interface TensorRegistrationResult {
+    tensor_id: string;
+    rack_repo_id: string | null;
+    rack_pinned: boolean;
+    attributed_to: string;
+    registration_cost_tokens: number | null;
+    tensor_size_mb: number | null;
+    lode_fingerprint: string | null;
+}
+interface StarResult {
+    success: boolean;
+    starred: boolean;
+    stars: number;
+    cost: number;
+    transaction_id?: string;
+}
+interface StarInfo {
+    stars: number;
+    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 CostEstimate {
+    type: 'skill' | 'tensor';
+    totalBytes: number;
+    totalMegabytes: number;
+    baseCost: number;
+    multiplier: number;
+    registrationCostTokens: number;
+}
 
-export type { DiffEntry, InitResult, PushResult, RackConfig, RepoCommit, RepoFile, RepoInfo, RepoTree, TreeEntry };
+export type { CostEstimate, DiffEntry, InitResult, NetworkStats, 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.1.0",
+  "version": "0.3.0",
   "description": "React hooks and components for reading and writing StackNet Racks",
   "type": "module",
   "main": "./dist/index.cjs",