@stacknet/stacks 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,335 @@
+export { A as ALL_CAPABILITIES_BITMASK, c as ActionProof, d as AddPointsInput, e as Agent, f as AgentCreateInput, g as AgentExecuteRequest, h as AgentExecuteResponse, i as AgentFromPromptInput, j as AgentResponse, k as AgentTrigger, l as AgentUpdateInput, m as AgentWorkflow, n as AgentWorkflowEdge, o as AgentWorkflowNode, p as AgentsClientConfig, q as AgentsListResponse, r as AllowlistConfig, s as AllowlistMode, t as AllowlistUpdateInput, u as AuthMetrics, B as BillingClientConfig, v as BillingPlan, w as BillingPlansResponse, x as BillingPortalResponse, y as BillingState, z as BillingTier, C as CAPABILITY_BITS, D as CapabilityKey, E as ChatCompletionChunk, F as ChatCompletionRequest, G as ChatCompletionResponse, H as CommentResponse, I as CommentsResponse, J as ConfigureOAuthInput, K as ConfigureStripeInput, L as ConfigureWeb3Input, M as ConsensusStateSummary, N as ConsensusStatus, O as ContextDomain, P as ContextResponse, Q as ContextsListResponse, R as CreateCheckoutSessionResponse, S as CreateContextInput, U as CreateDelegationInput, V as CreateDomainInput, W as CreateKeyResponse, X as CreatePostInput, Y as CreatePostResponse, Z as CreateStackRequest, _ as Delegation, $ as DelegationChainLink, a0 as DelegationFilters, a1 as DelegationResponse, a2 as DelegationScope, a3 as DelegationsListResponse, a4 as DomainResponse, a5 as DomainsListResponse, a6 as FeedResponse, a7 as FileUploadResponse, a8 as FilesClientConfig, a9 as HistoryFilters, aa as HistoryResponse, ab as ImaginationCharacter, ac as ImaginationMetadata, ad as ImaginationSource, ae as InitNetworkResponse, af as LeaderStatus, ag as LikeCheckResponse, ah as LikeResponse, ai as MCPContent, aj as MCPMessage, ak as MCPSession, al as MCPSessionConfig, am as MCPToolResult, an as MPCNode, ao as MagmaFile, ap as MediaType, aq as Message, ar as MeteredUsage, as as ModelLayerInfo, at as ModelLayersResponse, au as NetworkClientConfig, av as NetworkStatus, br as Orientation, aw as PaginationMeta, ax as PaymentRequiredResponse, ay as PointBalance, az as PointContext, aA as PointRecord, aB as PointRecordResponse, aC as PointSpend, aD as PointSpendResponse, aE as PointsClientConfig, aF as PostResponse, aG as ProfileResponse, aH as RemixesResponse, aI as Skill, aJ as SkillCreateInput, bp as SkillMapPromptResponse, bo as SkillMapResponse, aK as SkillResponse, bq as SkillSummaryResponse, aL as SkillUpdateInput, bn as SkillVerifyResponse, aM as SkillsClientConfig, aN as SkillsListResponse, aO as SocialAuthor, aP as SocialClientConfig, aQ as SocialComment, aR as SocialPost, aS as SocialRemix, aT as SpendDestination, aU as SpendPointsInput, aV as StackCapabilities, aW as StackConfig, aX as StackKeyInfo, aY as StackKeysListResponse, aZ as StackListResponse, a_ as StackManagementClientConfig, a$ as StackMember, b0 as StackMemberStats, b1 as StackModelAlias, b2 as StackOAuthProvider, b3 as StackResponse, b4 as StackStripeProvider, b5 as StackWeb3Provider, b6 as TaskPayload, b7 as TaskResponse, a as TaskState, b as TaskStatus, T as TaskType, b8 as UsageRecord, b9 as UserClientConfig, ba as UserProfile, bb as UserProfileResponse, bc as UserProfileUpdateInput, bd as Widget, be as WidgetCreateInput, bf as WidgetResponse, bg as WidgetSystemPromptResponse, bh as WidgetUpdateInput, bi as WidgetsClientConfig, bj as WidgetsListResponse, bk as WorkflowData, bl as bitmaskToCapabilities, bm as capabilitiesToBitmask } from '../billing-BaJlf_S8.js';
+
+/**
+ * Coder type definitions
+ * Types for the GeoffCoder AI coding agent
+ */
+type CoderSessionStatus = 'active' | 'completed' | 'aborted' | 'error';
+interface CoderSession {
+    id: string;
+    workingDirectory: string;
+    status: CoderSessionStatus;
+    createdAt: string;
+    updatedAt?: string;
+    metrics: CoderMetrics;
+    sandboxId?: string;
+}
+interface CoderMetrics {
+    tokensUsed: number;
+    promptTokens: number;
+    completionTokens: number;
+    contextSize: number;
+    filesCreated: number;
+    filesModified: number;
+    linesAdded: number;
+    linesRemoved: number;
+    commandsExecuted: number;
+    toolCallsTotal: number;
+    apiCalls: number;
+    startTime: number;
+    endTime?: number;
+    modifiedFiles: string[];
+    createdFiles: string[];
+}
+interface CoderExecuteRequest {
+    /** The prompt/task for the coder agent */
+    prompt: string;
+    /** Working directory for file operations */
+    workingDirectory?: string;
+    /** Maximum iterations for the agent loop */
+    maxIterations?: number;
+    /** Model to use for completions */
+    model?: string;
+    /** Maximum tokens per response */
+    maxTokens?: number;
+    /** Temperature for generation */
+    temperature?: number;
+    /** Whether to stream the response */
+    stream?: boolean;
+    /** Existing session ID to continue */
+    sessionId?: string;
+    /** Existing sandbox ID to use (from frontend) */
+    sandboxId?: string;
+    /** E2B sandbox configuration */
+    sandbox?: CoderSandboxConfig;
+    /** Chat ID for session tracking and approval responses */
+    chatId?: string;
+    /** API base URL for self-hosted inference endpoint */
+    apiBase?: string;
+    /** API key for authentication */
+    apiKey?: string;
+    /** Auto-approve tool execution (default: true for backward compatibility) */
+    autoApprove?: boolean;
+    /** Tool permission overrides */
+    toolPermissions?: Record<string, {
+        permission: 'always' | 'ask' | 'never';
+        allowlist?: string[];
+        denylist?: string[];
+    }>;
+}
+interface CoderSandboxConfig {
+    /** Enable sandbox execution */
+    enabled: boolean;
+    /** Sandbox template (e.g., 'node', 'python', 'nextjs') */
+    template?: string;
+    /** Session timeout in seconds */
+    timeout?: number;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Packages to pre-install */
+    packages?: string[];
+}
+interface CoderExecuteResponse {
+    sessionId: string;
+    status: CoderSessionStatus;
+    result?: string;
+    error?: string;
+    metrics: CoderMetrics;
+}
+type CoderStreamEventType = 'session_start' | 'thinking' | 'tool_call' | 'tool_result' | 'assistant_message' | 'progress' | 'metrics_update' | 'session_complete' | 'complete' | 'file_written' | 'file_modified' | 'sandbox_info' | 'session_files' | 'text' | 'done' | 'error' | 'approval_required' | 'approval_response' | 'tool_blocked' | 'context_compacted' | 'background_process_started' | 'background_process_completed' | 'session_saved' | 'session_resumed' | 'file_checkpoint' | 'memory_loaded' | 'question_asked' | 'question_answered' | 'blueprint_generated' | 'plan_progress' | 'token_usage' | 'task_created' | 'task_update';
+interface CoderStreamEvent {
+    type: CoderStreamEventType;
+    data: unknown;
+    timestamp: number;
+}
+interface CoderThinkingEvent {
+    type: 'thinking';
+    data: {
+        content: string;
+        iteration: number;
+    };
+}
+interface CoderToolCallEvent {
+    type: 'tool_call';
+    data: {
+        toolName: string;
+        arguments: Record<string, unknown>;
+        toolCallId: string;
+    };
+}
+interface CoderToolResultEvent {
+    type: 'tool_result';
+    data: {
+        toolCallId: string;
+        toolName: string;
+        success: boolean;
+        output: string;
+        error?: string;
+    };
+}
+interface CoderProgressEvent {
+    type: 'progress';
+    data: {
+        iteration: number;
+        maxIterations: number;
+        currentAction: string;
+    };
+}
+interface CoderTool {
+    name: string;
+    description: string;
+    parameters: {
+        type: 'object';
+        properties: Record<string, CoderToolParameter>;
+        required?: string[];
+    };
+}
+interface CoderToolParameter {
+    type: string;
+    description: string;
+    enum?: string[];
+}
+interface CoderToolResult {
+    success: boolean;
+    output: string;
+    error?: string;
+}
+interface CoderFileInfo {
+    name: string;
+    path: string;
+    size: number;
+    isDirectory: boolean;
+    modified?: string;
+    children?: CoderFileInfo[];
+}
+interface CoderFileContent {
+    path: string;
+    content: string;
+    encoding?: 'utf8' | 'base64';
+    size: number;
+}
+interface CoderFileWriteInput {
+    path: string;
+    content: string;
+    encoding?: 'utf8' | 'base64';
+    createDirectories?: boolean;
+}
+interface CoderSearchResult {
+    file: string;
+    line: number;
+    content: string;
+    contextBefore?: string[];
+    contextAfter?: string[];
+}
+interface CoderDiffInput {
+    path: string;
+    original: string;
+    replacement: string;
+    replaceAll?: boolean;
+}
+interface CoderCommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    executionTimeMs: number;
+}
+interface CoderCommandInput {
+    command: string;
+    timeout?: number;
+    cwd?: string;
+}
+interface CoderSandbox {
+    id: string;
+    status: 'creating' | 'ready' | 'busy' | 'stopped' | 'error';
+    template: string;
+    workingDirectory: string;
+    createdAt: string;
+    expiresAt?: string;
+}
+interface CoderSandboxCreateInput {
+    template?: string;
+    timeout?: number;
+    env?: Record<string, string>;
+    packages?: string[];
+}
+interface CoderSandboxExecInput {
+    command: string;
+    timeout?: number;
+    stream?: boolean;
+}
+interface CoderSandboxExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    executionTimeMs: number;
+}
+interface CoderSessionResponse {
+    session: CoderSession;
+}
+interface CoderSessionsListResponse {
+    sessions: CoderSession[];
+}
+interface CoderToolsResponse {
+    tools: CoderTool[];
+}
+interface CoderFilesResponse {
+    files: CoderFileInfo[];
+    path: string;
+}
+interface CoderSandboxResponse {
+    sandbox: CoderSandbox;
+}
+interface CoderClientConfig {
+    /** Base URL for the task network API */
+    baseUrl?: string;
+    /** API key for authentication */
+    apiKey?: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Default model for coder sessions */
+    defaultModel?: string;
+    /** Default max iterations */
+    defaultMaxIterations?: number;
+}
+
+/**
+ * Credential and identity type definitions
+ */
+type AuthMethod = 'email' | 'web3_evm' | 'web3_solana' | 'web3_bitcoin' | 'web3_cosmos' | 'oauth_google' | 'oauth_github' | 'oauth_discord' | 'oauth_twitter';
+type Web3Chain = 'ethereum' | 'solana' | 'bitcoin' | 'cosmos' | 'polygon' | 'arbitrum' | 'base';
+type CredentialType = 'email' | 'web3_wallet' | 'oauth_social' | 'billing_stripe' | 'stripe_connect';
+interface StackCredential {
+    id: string;
+    stack_identity_id: string;
+    credential_type: CredentialType;
+    credential_data: EmailCredentialData | Web3CredentialData | OAuthCredentialData | BillingCredentialData | StripeConnectCredentialData;
+    is_primary: boolean;
+    linked_at: number;
+}
+interface EmailCredentialData {
+    email_hash: string;
+    verified: boolean;
+    verified_at?: number;
+}
+interface Web3CredentialData {
+    chain: Web3Chain;
+    address: string;
+    address_type: 'p2wpkh' | 'p2tr' | 'ed25519' | 'secp256k1';
+    verification_signature: string;
+    verified_at: number;
+}
+interface OAuthCredentialData {
+    provider: 'google' | 'github' | 'discord' | 'twitter';
+    provider_user_id: string;
+    handle?: string;
+    verified_at: number;
+}
+interface BillingCredentialData {
+    provider: 'stripe';
+    customer_id: string;
+    has_payment_method: boolean;
+    default_payment_method_id?: string;
+    card_last_four?: string;
+    card_brand?: string;
+    billing_email?: string;
+    verified_at: number;
+}
+interface StripeConnectCredentialData {
+    provider: 'stripe_connect';
+    account_id: string;
+    details_submitted: boolean;
+    charges_enabled: boolean;
+    payouts_enabled: boolean;
+    email?: string;
+    verified_at: number;
+}
+interface CredentialLinkProof {
+    chain?: Web3Chain;
+    message?: string;
+    signature?: string;
+    public_key?: string;
+    provider?: string;
+    code?: string;
+    email?: string;
+}
+interface GlobalIdentity {
+    id: string;
+    identity_commitment: string;
+    root_public_key: string;
+    recovery_commitments: string[];
+    created_at: number;
+    updated_at: number;
+}
+interface StackIdentity {
+    id: string;
+    global_identity_id: string;
+    stack_id: string;
+    stack_public_key: string;
+    created_at: number;
+    last_login: number;
+}
+interface Session {
+    id: string;
+    app_identity_id: string;
+    global_identity_commitment: string;
+    app_id: string;
+    credentials: string[];
+    app_pubkey: string;
+    jwt: string;
+    issued_at: number;
+    expires_at: number;
+    issuer: string;
+    signed_by: string[];
+}
+
+export type { AuthMethod, BillingCredentialData, CoderClientConfig, CoderCommandInput, CoderCommandResult, CoderDiffInput, CoderExecuteRequest, CoderExecuteResponse, CoderFileContent, CoderFileInfo, CoderFileWriteInput, CoderFilesResponse, CoderMetrics, CoderProgressEvent, CoderSandbox, CoderSandboxConfig, CoderSandboxCreateInput, CoderSandboxExecInput, CoderSandboxExecResult, CoderSandboxResponse, CoderSearchResult, CoderSession, CoderSessionResponse, CoderSessionStatus, CoderSessionsListResponse, CoderStreamEvent, CoderStreamEventType, CoderThinkingEvent, CoderTool, CoderToolCallEvent, CoderToolParameter, CoderToolResult, CoderToolResultEvent, CoderToolsResponse, CredentialLinkProof, CredentialType, EmailCredentialData, GlobalIdentity, OAuthCredentialData, Session, StackCredential, StackIdentity, StripeConnectCredentialData, Web3Chain, Web3CredentialData };

package/dist/types/index.js

@@ -0,0 +1 @@
+var o={text_input:1,image_input:2,file_input:4,audio_input:8,video_input:16,music_input:32,text_output:64,image_output:128,audio_output:256,video_output:512,embeddings_output:1024,music_output:2048,skills:4096,loops:8192,tools:16384,pipelines:32768,training:65536},n=131071;function a(t){let e=0;for(let[i,r]of Object.entries(o))t[i]&&(e|=r);return e}function s(t){let e={};for(let[i,r]of Object.entries(o))e[i]=(t&r)!==0;return e}export{n as ALL_CAPABILITIES_BITMASK,o as CAPABILITY_BITS,s as bitmaskToCapabilities,a as capabilitiesToBitmask};

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@stacknet/stacks",
+  "version": "0.1.0",
+  "description": "SDK for connecting to StackNet",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./clients": {
+      "types": "./dist/clients/index.d.ts",
+      "import": "./dist/clients/index.js",
+      "require": "./dist/clients/index.cjs"
+    },
+    "./streaming": {
+      "types": "./dist/streaming/index.d.ts",
+      "import": "./dist/streaming/index.js",
+      "require": "./dist/streaming/index.cjs"
+    },
+    "./proxy": {
+      "types": "./dist/proxy/index.d.ts",
+      "import": "./dist/proxy/index.js",
+      "require": "./dist/proxy/index.cjs"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js",
+      "require": "./dist/types/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+"build": "tsup",
+    "build:publish": "tsup --no-sourcemap --minify",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm run clean && pnpm run typecheck && pnpm run build:publish",
+    "release": "pnpm run prepublishOnly && npm publish --access public"
+  },
+  "dependencies": {
+    "@xenova/transformers": "^2.17.2",
+    "redis": "^4.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "next": ">=14.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "stacknet",
+    "stacks",
+    "p2p",
+    "task-network",
+    "ai",
+    "sdk"
+  ],
+  "license": "MIT"
+}

package/src/clients/agents.ts

@@ -0,0 +1,233 @@
+/**
+ * Agents Client
+ * Client for interacting with the agents API
+ */
+
+import { DEFAULT_TASK_NETWORK_URL, JSON_HEADERS } from '../utils/constants';
+import { StacksSDKError } from '../utils/errors';
+import type {
+  Agent,
+  AgentsListResponse,
+  AgentResponse,
+  AgentCreateInput,
+  AgentUpdateInput,
+  AgentFromPromptInput,
+  AgentExecuteRequest,
+  AgentExecuteResponse,
+  AgentsClientConfig,
+} from '../types/agent';
+
+export type { AgentsClientConfig } from '../types/agent';
+
+export class AgentsClient {
+  private baseUrl: string;
+  private useCpxApi: boolean;
+
+  constructor(config: AgentsClientConfig = {}) {
+    this.baseUrl = config.baseUrl || DEFAULT_TASK_NETWORK_URL;
+    // Use coprocessor API by default (can be disabled for backwards compatibility)
+    this.useCpxApi = config.useCpxApi !== false;
+  }
+
+  private get agentsUrl(): string {
+    // Route through Agent Coprocessor at /cpx/agent/agents
+    return this.useCpxApi
+      ? `${this.baseUrl}/cpx/agent/agents`
+      : `${this.baseUrl}/agents`;
+  }
+
+  /**
+   * List all agents
+   */
+  async list(options: { userMid?: string } = {}): Promise<AgentsListResponse> {
+    const params = new URLSearchParams();
+    if (options.userMid) {
+      params.set('userMid', options.userMid);
+    }
+
+    const queryString = params.toString();
+    const url = `${this.agentsUrl}${queryString ? `?${queryString}` : ''}`;
+
+    const response = await fetch(url);
+
+    if (!response.ok) {
+      throw new StacksSDKError(
+        'bad_request:api',
+        `Failed to list agents: ${response.statusText}`
+      );
+    }
+
+    return response.json();
+  }
+
+  /**
+   * Get an agent by ID
+   */
+  async get(id: string): Promise<Agent> {
+    const response = await fetch(`${this.agentsUrl}/${id}`);
+
+    if (!response.ok) {
+      throw new StacksSDKError(
+        response.status === 404 ? 'not_found:api' : 'bad_request:api',
+        `Failed to get agent: ${response.statusText}`
+      );
+    }
+
+    return response.json();
+  }
+
+  /**
+   * Create a new agent
+   */
+  async create(input: AgentCreateInput): Promise<AgentResponse> {
+    const response = await fetch(this.agentsUrl, {
+      method: 'POST',
+      headers: JSON_HEADERS,
+      body: JSON.stringify(input),
+    });
+
+    if (!response.ok) {
+      const data = await response.json().catch(() => ({}));
+      throw new StacksSDKError(
+        'bad_request:api',
+        data.error || `Failed to create agent: ${response.statusText}`
+      );
+    }
+
+    return response.json();
+  }
+
+  /**
+   * Update an agent
+   */
+  async update(id: string, input: AgentUpdateInput): Promise<AgentResponse> {
+    const response = await fetch(`${this.agentsUrl}/${id}`, {
+      method: 'PUT',
+      headers: JSON_HEADERS,
+      body: JSON.stringify(input),
+    });
+
+    if (!response.ok) {
+      const data = await response.json().catch(() => ({}));
+      throw new StacksSDKError(
+        'bad_request:api',
+        data.error || `Failed to update agent: ${response.statusText}`
+      );
+    }
+
+    return response.json();
+  }
+
+  /**
+   * Delete an agent
+   */
+  async delete(id: string): Promise<{ success: boolean }> {
+    const response = await fetch(`${this.agentsUrl}/${id}`, {
+      method: 'DELETE',
+    });
+
+    if (!response.ok) {
+      throw new StacksSDKError(
+        'bad_request:api',
+        `Failed to delete agent: ${response.statusText}`
+      );
+    }
+
+    return response.json();
+  }
+
+  /**
+   * Enable an agent
+   */
+  async enable(id: string): Promise<AgentResponse> {
+    const response = await fetch(`${this.agentsUrl}/${id}/enable`, {
+      method: 'POST',
+    });
+
+    if (!response.ok) {
+      throw new StacksSDKError(
+        'bad_request:api',
+        `Failed to enable agent: ${response.statusText}`
+      );
+    }
+
+    return response.json();
+  }
+
+  /**
+   * Disable an agent
+   */
+  async disable(id: string): Promise<AgentResponse> {
+    const response = await fetch(`${this.agentsUrl}/${id}/disable`, {
+      method: 'POST',
+    });
+
+    if (!response.ok) {
+      throw new StacksSDKError(
+        'bad_request:api',
+        `Failed to disable agent: ${response.statusText}`
+      );
+    }
+
+    return response.json();
+  }
+
+  /**
+   * Execute an agent
+   */
+  async execute(id: string, request: AgentExecuteRequest = {}): Promise<AgentExecuteResponse> {
+    const response = await fetch(`${this.agentsUrl}/${id}/execute`, {
+      method: 'POST',
+      headers: JSON_HEADERS,
+      body: JSON.stringify(request),
+    });
+
+    if (!response.ok) {
+      throw new StacksSDKError(
+        'bad_request:api',
+        `Failed to execute agent: ${response.statusText}`
+      );
+    }
+
+    return response.json();
+  }
+
+  /**
+   * Create agent from prompt (AI-generated)
+   */
+  async createFromPrompt(input: AgentFromPromptInput): Promise<AgentResponse> {
+    // First, generate agent config from prompt
+    const generateResponse = await fetch(`${this.agentsUrl}/from-prompt`, {
+      method: 'POST',
+      headers: JSON_HEADERS,
+      body: JSON.stringify(input),
+    });
+
+    if (!generateResponse.ok) {
+      throw new StacksSDKError(
+        'bad_request:api',
+        `Failed to generate agent from prompt: ${generateResponse.statusText}`
+      );
+    }
+
+    const agentConfig = await generateResponse.json();
+
+    // Then create the agent
+    return this.create({
+      ...agentConfig,
+      created_by: input.created_by,
+    });
+  }
+}
+
+/**
+ * Create an AgentsClient instance
+ */
+export function createAgentsClient(config: AgentsClientConfig = {}): AgentsClient {
+  return new AgentsClient(config);
+}
+
+/**
+ * Default agents client instance
+ */
+export const agentsClient = createAgentsClient();