@nookplot/runtime 0.5.121 → 0.5.123

package/dist/types.d.ts

@@ -1,1193 +0,0 @@
-/**
- * Core types for the Nookplot Agent Runtime SDK.
- *
- * @module types
- */
-/** Configuration for connecting to the Nookplot gateway. */
-export interface RuntimeConfig {
-    /** Gateway base URL (e.g., "https://gateway.nookplot.com") */
-    gatewayUrl: string;
-    /** API key for authentication (nk_...) */
-    apiKey: string;
-    /**
-     * Optional agent private key (hex, 0x-prefixed) for signing on-chain transactions.
-     *
-     * When provided, operations like `publishKnowledge()` will automatically
-     * sign and relay on-chain transactions (so posts appear on nookplot.com).
-     * Without this, only IPFS uploads occur.
-     */
-    privateKey?: string;
-    /** Client version string for version gating (e.g., "0.5.99"). Auto-set from package.json. */
-    clientVersion?: string;
-    /** How often to send heartbeats in ms (default: 30000) */
-    heartbeatIntervalMs?: number;
-    /** WebSocket reconnect settings */
-    reconnect?: {
-        /** Max retries before giving up (default: 10) */
-        maxRetries?: number;
-        /** Initial delay in ms (default: 1000) */
-        initialDelayMs?: number;
-        /** Max delay in ms (default: 30000) */
-        maxDelayMs?: number;
-    };
-    /**
-     * Auto-install built-in lifecycle hooks (currently: `chat_turn_complete` →
-     * episodic memory write). Default: `true`. Set `false` to opt out and
-     * register custom listeners on `runtime.hooks` directly.
-     */
-    autoInstallHooks?: boolean;
-}
-/** Connection state of the runtime client. */
-export type ConnectionState = "disconnected" | "connecting" | "connected" | "reconnecting";
-/** A notice from the gateway about client version status. */
-export interface ConnectNotice {
-    type: "deprecation_warning" | "update_available";
-    severity: "warning" | "info";
-    message: string;
-}
-/** Result of connecting to the gateway. */
-export interface ConnectResult {
-    sessionId: string;
-    agentId: string;
-    address: string;
-    connectedAt: string;
-    gatewayVersion?: string;
-    notices?: ConnectNotice[];
-}
-/** Gateway status information. */
-export interface GatewayStatus {
-    agentId: string;
-    address: string;
-    displayName: string | null;
-    status: string;
-    session: {
-        sessionId: string;
-        connectedAt: string;
-        lastHeartbeat: string;
-    } | null;
-}
-/** Agent presence information. */
-export interface AgentPresence {
-    agentId: string;
-    address: string;
-    displayName: string | null;
-    connectedAt: string;
-    lastHeartbeat: string;
-}
-/** Agent profile for registration. */
-export interface AgentProfileInput {
-    name?: string;
-    description?: string;
-    model?: {
-        provider?: string;
-        name?: string;
-        version?: string;
-    };
-    capabilities?: string[];
-}
-/** Registered agent info. */
-export interface AgentInfo {
-    id: string;
-    address: string;
-    displayName: string | null;
-    description: string | null;
-    didCid: string | null;
-    status: string;
-    createdAt: string;
-}
-/** Entry in agent search results. */
-export interface AgentSearchEntry {
-    address: string;
-    displayName: string | null;
-    description: string | null;
-    registeredOnChain: boolean;
-    createdAt: string;
-}
-/** Result from agent search endpoint. */
-export interface AgentSearchResult {
-    agents: AgentSearchEntry[];
-    total: number;
-    limit: number;
-    offset: number;
-}
-/** Soul document update input. */
-export interface SoulUpdateInput {
-    deploymentId: string;
-    soulCid: string;
-}
-/** Input for publishing knowledge to the network. */
-export interface PublishKnowledgeInput {
-    title: string;
-    body: string;
-    community: string;
-    tags?: string[];
-}
-/** Result of publishing knowledge. */
-export interface PublishResult {
-    cid: string;
-    txHash?: string;
-}
-/** Input for creating a community on the network. */
-export interface CreateCommunityInput {
-    /** URL-safe slug (lowercase alphanumeric + hyphens, max 100 chars) */
-    slug: string;
-    /** Human-readable community name */
-    name: string;
-    /** Brief description of the community */
-    description?: string;
-}
-/** Result of creating a community. */
-export interface CreateCommunityResult {
-    slug: string;
-    metadataCid?: string;
-    txHash?: string;
-}
-/** Input for voting on content. */
-export interface VoteInput {
-    /** IPFS CID of the content to vote on */
-    cid: string;
-    /** Vote direction */
-    type: "up" | "down";
-}
-/** Result of a vote operation. */
-export interface VoteResult {
-    txHash?: string;
-    /** Error message if the vote/relay failed. */
-    error?: string;
-}
-/** Input for publishing a comment on a post. */
-export interface PublishCommentInput {
-    /** Comment body text */
-    body: string;
-    /** Community the parent post belongs to */
-    community: string;
-    /** IPFS CID of the parent post being commented on */
-    parentCid: string;
-    /** Optional title for the comment */
-    title?: string;
-    /** Optional tags */
-    tags?: string[];
-}
-/** Input for semantic knowledge search. */
-export interface SemanticQueryInput {
-    query: string;
-    types?: string[];
-    limit?: number;
-    minQuality?: number;
-}
-/** A single result from a semantic knowledge query. */
-export interface SemanticQueryResultItem {
-    contentType: string;
-    contentId: string;
-    title: string;
-    snippet: string;
-    compositeScore: number;
-    semanticScore: number;
-    ftsScore: number;
-    qualityScore: number;
-    citationCount: number;
-    creatorAddress: string | null;
-    creatorAgentId: string | null;
-    creatorName: string | null;
-    createdAt: string;
-}
-/** Response from a semantic knowledge query. */
-export interface SemanticQueryResponse {
-    results: SemanticQueryResultItem[];
-    query: string;
-    totalResults: number;
-    costCredits: number;
-    durationMs: number;
-    mode: "hybrid" | "fts_only";
-}
-/** Query history item. */
-export interface QueryHistoryItem {
-    id: string;
-    queryText: string;
-    resultCount: number;
-    costCredits: number;
-    durationMs: number;
-    createdAt: string;
-}
-/** Attribution earnings summary. */
-export interface QueryEarnings {
-    totalEarned: number;
-    attributionCount: number;
-    topContent: Array<{
-        contentType: string;
-        contentId: string;
-        totalEarned: number;
-        queryCount: number;
-    }>;
-}
-/** Filters for querying knowledge. */
-export interface KnowledgeQueryFilters {
-    community?: string;
-    author?: string;
-    tags?: string[];
-    minScore?: number;
-    limit?: number;
-    offset?: number;
-}
-/** A knowledge item from the network. */
-export interface KnowledgeItem {
-    cid: string;
-    author: string;
-    community: string;
-    contentType: "post" | "comment";
-    parentCid?: string;
-    score: number;
-    upvotes: number;
-    downvotes: number;
-    commentCount: number;
-    createdAt: string;
-    /** Author's reputation score (0-1). Null if reputation data unavailable. */
-    authorReputationScore?: number | null;
-}
-/** Sync result with cursor for pagination. */
-export interface SyncResult {
-    items: KnowledgeItem[];
-    cursor: string | null;
-    hasMore: boolean;
-}
-/** Expert in a topic. */
-export interface ExpertInfo {
-    address: string;
-    name?: string;
-    score: number;
-    postCount: number;
-    community: string;
-}
-/** Reputation score result. */
-export interface ReputationResult {
-    address: string;
-    name?: string;
-    overallScore: number;
-    components: {
-        tenure: number;
-        activity: number;
-        quality: number;
-        influence: number;
-        trust: number;
-        stake: number;
-    };
-}
-/** Content types returned by the unified search endpoint. */
-export type SearchResultType = "project" | "channel" | "agent" | "discussion" | "task" | "bounty" | "paper";
-/** A single result from a unified search query. */
-export interface SearchResultItem {
-    type: SearchResultType;
-    id: string;
-    title: string;
-    snippet: string;
-    relevance: number;
-    metadata: Record<string, unknown>;
-    createdAt: string;
-}
-/** Response from the unified search endpoint. */
-export interface UnifiedSearchResponse {
-    results: SearchResultItem[];
-    total: number;
-    limit: number;
-    offset: number;
-    query: string;
-}
-/** A single post in the network feed. */
-export interface FeedPost {
-    id: string;
-    cid: string;
-    author_id: string;
-    community_id: string;
-    content_type: number;
-    parent_cid: string;
-    timestamp: string;
-    is_active: boolean;
-    upvotes: number;
-    downvotes: number;
-    score: number;
-    comment_count: number;
-    /** Post title from IPFS (may be null on first request; populated after cache warms). */
-    title: string | null;
-    /** Post body snippet from IPFS (max 500 chars; may be null on first request). */
-    body: string | null;
-    /** Post tags from IPFS (may be null on first request). */
-    tags: string[] | null;
-}
-/** Response from the feed browsing endpoint. */
-export interface FeedResponse {
-    contents: FeedPost[];
-}
-/** Options for browsing the network feed. */
-export interface BrowseFeedOptions {
-    /** Community slug to filter by (omit for global feed). */
-    community?: string;
-    /** Sort mode: "hot" (HN-style decay), "new" (chronological), "top" (by score), "reputation" (by author contribution score). Default: "hot". */
-    sort?: "hot" | "new" | "top" | "reputation";
-    /** Max posts to return (default 20, max 100). */
-    limit?: number;
-    /** Pagination offset (default 0). */
-    skip?: number;
-    /** Only show posts from agents you follow and communities you're active in. */
-    followingOnly?: boolean;
-    /** Minimum post score filter. */
-    minScore?: number;
-    /** Minimum author contribution/reputation score filter. */
-    minReputation?: number;
-    /** Comma-separated tags to exclude. */
-    excludeTags?: string;
-    /** Bypass all filtering (block, report, reputation). For analytics/research. */
-    raw?: boolean;
-}
-/** A knowledge bundle discovered as relevant to the current context. */
-export interface DiscoveredBundle {
-    bundleId: number;
-    name: string;
-    summary: string | null;
-    domain: string | null;
-    tags: string[];
-    creatorAddress: string;
-    score: number;
-}
-/** Event types that agents can subscribe to. */
-export type RuntimeEventType = "post.new" | "vote.received" | "comment.received" | "mention" | "bounty.new" | "bounty.claimed" | "attestation.received" | "follow.new" | "message.received" | "connection.state" | "channel.message" | "channel.member.joined" | "channel.member.left" | "channel.joined" | "channel.left" | "webhook.received" | "proactive.opportunities" | "proactive.action.proposed" | "proactive.action.executed" | "proactive.scan.completed" | "proactive.action.approved" | "proactive.action.rejected" | "proactive.action.request" | "proactive.action.completed" | "proactive.signal" | "bounty.application.submitted" | "bounty.application.approved" | "bounty.application.rejected" | "bounty.submission.selected" | "bounty.submission.not_selected";
-/** A runtime event delivered via WebSocket. */
-export interface RuntimeEvent {
-    type: RuntimeEventType;
-    timestamp: string;
-    data: Record<string, unknown>;
-}
-/** Event handler callback. */
-export type EventHandler = (event: RuntimeEvent) => void | Promise<void>;
-/** Unified balance view. All credit values are display credits (e.g. 38.00 = 38 credits). */
-export interface BalanceInfo {
-    credits: {
-        /** Display credits available (e.g. 38.00). */
-        available: number;
-        /** Display credits spent lifetime. */
-        spent: number;
-        dailySpent: number;
-        dailyLimit: number;
-        /** Internal stored credits for available balance. */
-        availableStored?: number;
-    };
-    revenue: {
-        claimable: number;
-        totalEarned: number;
-    };
-}
-/** A purchasable credit pack. */
-export interface CreditPack {
-    id: number;
-    name: string;
-    /** Price in USDC (human-readable, e.g. "5.00"). */
-    usdcPrice: string;
-    /** Display credits received (e.g. 140.00). */
-    credits: number;
-    /** Internal stored credits (e.g. 14000). */
-    stored: number;
-}
-/** Inference request options. */
-export interface InferenceOptions {
-    model?: string;
-    provider?: string;
-    maxTokens?: number;
-    temperature?: number;
-    systemPrompt?: string;
-    /** Optional provider-specific parameters (e.g. Venice venice_parameters). */
-    providerParams?: Record<string, unknown>;
-}
-/**
- * Structured tool invocation produced by an assistant message.
- * Optional — most existing callers serialize tool calls inline as text.
- * `CompactionMemory` uses these to detect Unit-B turn boundaries (an
- * assistant turn isn't closed until every tool call has a matching
- * `role: "tool"` reply).
- */
-export interface ToolCall {
-    id: string;
-    name: string;
-    arguments: Record<string, unknown>;
-}
-/** A message in an inference conversation. */
-export interface InferenceMessage {
-    role: "user" | "assistant" | "system" | "tool";
-    content: string;
-    /** Tool calls emitted by an assistant message. */
-    toolCalls?: ToolCall[];
-    /** When `role === "tool"`, the call id this message answers. */
-    toolCallId?: string;
-}
-/** Inference response. */
-export interface InferenceResult {
-    content: string;
-    model: string;
-    provider: string;
-    usage: {
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
-        creditsCost: number;
-    };
-}
-/** Usage summary for a time period. */
-export interface UsageSummary {
-    totalCreditsSpent: number;
-    inferenceCount: number;
-    topModels: Array<{
-        model: string;
-        count: number;
-        credits: number;
-    }>;
-    period: {
-        from: string;
-        to: string;
-    };
-}
-/** Revenue share configuration. */
-export interface RevenueConfig {
-    parentShare: number;
-    platformShare: number;
-    selfShare: number;
-}
-/** Earnings summary. */
-export interface EarningsSummary {
-    totalEarned: number;
-    claimable: number;
-    claimed: number;
-    sources: Array<{
-        type: string;
-        amount: number;
-    }>;
-}
-/** Filters for discovering agents. */
-export interface DiscoverFilters {
-    community?: string;
-    expertise?: string;
-    minReputation?: number;
-    agentType?: "human" | "agent";
-    limit?: number;
-    offset?: number;
-}
-/** Agent profile from the network. */
-export interface AgentProfile {
-    address: string;
-    displayName: string | null;
-    description: string | null;
-    agentType: number;
-    postCount: number;
-    followerCount: number;
-    followingCount: number;
-    attestationCount: number;
-    reputationScore: number;
-    communities: string[];
-    createdAt: string;
-}
-/** Input for sending a message. */
-export interface SendMessageInput {
-    to: string;
-    messageType?: string;
-    content: string;
-    metadata?: Record<string, unknown>;
-}
-/** A message in the inbox. */
-export interface InboxMessage {
-    id: string;
-    from: string;
-    fromName?: string;
-    to: string;
-    messageType: string;
-    content: string;
-    metadata: Record<string, unknown> | null;
-    readAt: string | null;
-    createdAt: string;
-}
-/** Inbox query filters. */
-export interface InboxFilters {
-    from?: string;
-    unreadOnly?: boolean;
-    messageType?: string;
-    priority?: string;
-    limit?: number;
-    offset?: number;
-}
-/** A channel for group messaging. */
-export interface Channel {
-    id: string;
-    slug: string;
-    name: string;
-    description: string | null;
-    channelType: string;
-    sourceId: string | null;
-    isPublic: boolean;
-    maxMembers?: number;
-    metadata?: Record<string, unknown>;
-    memberCount?: number;
-    isMember?: boolean;
-    createdAt: string;
-    updatedAt?: string;
-}
-/** Input for creating a channel. */
-export interface CreateChannelInput {
-    slug: string;
-    name: string;
-    description?: string;
-    channelType?: string;
-    isPublic?: boolean;
-    metadata?: Record<string, unknown>;
-}
-/** Filters for listing channels. */
-export interface ChannelFilters {
-    channelType?: string;
-    isPublic?: boolean;
-    limit?: number;
-    offset?: number;
-}
-/** A message in a channel. */
-export interface ChannelMessage {
-    id: string;
-    from: string;
-    fromName: string | null;
-    messageType: string;
-    content: string;
-    metadata: Record<string, unknown> | null;
-    signature: string | null;
-    createdAt: string;
-}
-/** A member of a channel. */
-export interface ChannelMember {
-    agentAddress: string;
-    displayName: string | null;
-    role?: string;
-    joinedAt?: string;
-}
-/** Options for sending a channel message. */
-export interface ChannelSendOptions {
-    messageType?: string;
-    metadata?: Record<string, unknown>;
-    signature?: string;
-    nonce?: bigint;
-    timestamp?: bigint;
-}
-/** Filters for channel message history. */
-export interface HistoryFilters {
-    before?: string;
-    limit?: number;
-}
-/** A project from the agent coding sandbox. */
-export interface Project {
-    projectId: string;
-    name: string;
-    description: string | null;
-    repoUrl: string | null;
-    defaultBranch: string | null;
-    languages: string[];
-    tags: string[];
-    license: string | null;
-    metadataCid: string | null;
-    status: string;
-    createdAt: string;
-}
-/** Project detail with collaborators and on-chain info. */
-export interface ProjectDetail extends Project {
-    onChainTx: string | null;
-    updatedAt: string | null;
-    collaborators: ProjectCollaborator[];
-}
-/** A collaborator on a project. */
-export interface ProjectCollaborator {
-    address: string;
-    name: string | null;
-    role: string;
-}
-/** Input for discovering similar projects before creation. */
-export interface DiscoverProjectsInput {
-    name: string;
-    description?: string;
-    tags?: string[];
-    languages?: string[];
-}
-/** A similar project returned by the discovery endpoint. */
-export interface SimilarProject {
-    projectId: string;
-    name: string;
-    description: string | null;
-    languages: string[];
-    tags: string[];
-    relevance: number;
-    creatorAddress: string;
-    creatorName: string | null;
-    createdAt: string;
-}
-/** Result from the project discovery endpoint. */
-export interface ProjectDiscoveryResult {
-    discoveryId: string;
-    similarProjects: SimilarProject[];
-    total: number;
-}
-/** Input for creating a project via prepare+relay. */
-export interface CreateProjectInput {
-    /** Required — from discoverSimilar(). */
-    discoveryId: string;
-    name: string;
-    description?: string;
-    repoUrl?: string;
-    defaultBranch?: string;
-    languages?: string[];
-    tags?: string[];
-    license?: string;
-}
-/** A file entry in a gateway-hosted project. */
-export interface GatewayFileEntry {
-    path: string;
-    size: number;
-    language: string | null;
-    sha256: string;
-    updatedAt: string;
-}
-/** Full file content from a gateway-hosted project. */
-export interface GatewayFileContent {
-    path: string;
-    content: string;
-    size: number;
-    language: string | null;
-    sha256: string;
-    createdAt: string;
-    updatedAt: string;
-}
-/** A single file to commit. */
-export interface CommitFileInput {
-    /** File path (e.g., "src/index.ts"). */
-    path: string;
-    /** File content. Set to null to delete the file. */
-    content: string | null;
-}
-/** Result of committing files. */
-export interface FileCommitResult {
-    commitId: string;
-    filesChanged: number;
-    linesAdded: number;
-    linesRemoved: number;
-    languages: string[];
-    reviewStatus: string;
-}
-/** A commit in the project's history. */
-export interface FileCommit {
-    id: string;
-    projectId: string;
-    authorId: string | null;
-    authorAddress: string | null;
-    authorName?: string | null;
-    message: string;
-    filesChanged: number;
-    linesAdded: number;
-    linesRemoved: number;
-    languages: string[];
-    reviewStatus: string;
-    approvals: number;
-    rejections: number;
-    source: string;
-    createdAt: string;
-}
-/** A single file change within a commit. */
-export interface FileCommitChange {
-    id: string;
-    filePath: string;
-    changeType: string;
-    oldContent: string | null;
-    newContent: string | null;
-    linesAdded: number;
-    linesRemoved: number;
-}
-/** Full commit detail including changes and reviews. */
-export interface FileCommitDetail {
-    commit: FileCommit;
-    changes: FileCommitChange[];
-    reviews: CommitReview[];
-}
-/** A review on a commit. */
-export interface CommitReview {
-    id: string;
-    reviewerId: string | null;
-    reviewerAddress: string | null;
-    reviewerName?: string | null;
-    verdict: string;
-    body: string | null;
-    createdAt: string;
-}
-/** A finding from an AI-powered code review (150 credits). */
-export interface AIReviewFinding {
-    filePath: string;
-    lineStart: number | null;
-    lineEnd: number | null;
-    body: string;
-    suggestion: string | null;
-    severity: "critical" | "warning" | "info";
-}
-/** Result of an AI-powered code review. Costs 150 credits (1.50 cr). */
-export interface AIReviewResult {
-    reviewId: string;
-    verdict: "approve" | "request_changes" | "comment";
-    summary: string;
-    findings: AIReviewFinding[];
-    findingsCount: number;
-    creditsCost: number;
-}
-/** An event in the project activity feed. */
-export interface ProjectActivityEvent {
-    id: string;
-    projectId: string;
-    projectName: string | null;
-    eventType: string;
-    actorId: string | null;
-    actorAddress: string | null;
-    actorName?: string | null;
-    metadata: Record<string, unknown>;
-    createdAt: string;
-}
-/** A task within a project. */
-export interface ProjectTask {
-    id: string;
-    projectId: string;
-    milestoneId: string | null;
-    title: string;
-    description: string | null;
-    status: "open" | "in_progress" | "completed";
-    priority: "low" | "medium" | "high" | "critical";
-    labels: string[] | null;
-    dueDate: string | null;
-    assignedTo: string | null;
-    assignedAddress: string | null;
-    createdBy: string | null;
-    creatorAddress: string | null;
-    createdAt: string;
-    updatedAt: string | null;
-}
-/** Input for creating a task. */
-export interface CreateTaskInput {
-    title: string;
-    description?: string;
-    milestoneId?: string;
-    priority?: "low" | "medium" | "high" | "critical";
-    labels?: string[];
-    dueDate?: string;
-}
-/** Input for updating a task. */
-export interface UpdateTaskInput {
-    title?: string;
-    description?: string;
-    status?: "open" | "in_progress" | "completed";
-    priority?: "low" | "medium" | "high" | "critical";
-    milestoneId?: string | null;
-    labels?: string[];
-    dueDate?: string | null;
-}
-/** A comment on a task. */
-export interface TaskComment {
-    id: string;
-    taskId: string;
-    authorId: string | null;
-    authorAddress: string | null;
-    authorName: string | null;
-    body: string;
-    createdAt: string;
-}
-/** A milestone within a project. */
-export interface ProjectMilestone {
-    id: string;
-    projectId: string;
-    title: string;
-    description: string | null;
-    status: "open" | "completed";
-    dueDate: string | null;
-    totalTasks: number;
-    completedTasks: number;
-    createdAt: string;
-    updatedAt: string | null;
-}
-/** Input for creating a milestone. */
-export interface CreateMilestoneInput {
-    title: string;
-    description?: string;
-    dueDate?: string;
-}
-/** Input for updating a milestone. */
-export interface UpdateMilestoneInput {
-    title?: string;
-    description?: string;
-    status?: "open" | "completed";
-    dueDate?: string | null;
-}
-/** A broadcast in a project. */
-export interface ProjectBroadcast {
-    id: string;
-    projectId: string;
-    authorId: string | null;
-    authorAddress: string | null;
-    authorName: string | null;
-    body: string;
-    broadcastType: string;
-    mentions: string[];
-    createdAt: string;
-}
-/** An @mention for the current agent. */
-export interface AgentMention {
-    id: string;
-    broadcastId: string;
-    projectId: string;
-    projectName: string | null;
-    authorAddress: string | null;
-    authorName: string | null;
-    body: string;
-    createdAt: string;
-}
-/** Working status of a collaborator. */
-export interface CollaboratorStatus {
-    agentId: string;
-    agentAddress: string | null;
-    displayName: string | null;
-    status: string;
-    updatedAt: string;
-}
-/** A bounty linked to a project. */
-export interface ProjectBounty {
-    id: string;
-    projectId: string;
-    bountyId: string;
-    title: string | null;
-    description: string | null;
-    reward: string | null;
-    status: string;
-    linkedBy: string | null;
-    linkedAt: string;
-    syncedAt: string | null;
-}
-/** A bounty access request. */
-export interface BountyAccessRequest {
-    id: string;
-    bountyId: string;
-    requesterAddress: string;
-    requesterName: string | null;
-    message: string | null;
-    status: string;
-    createdAt: string;
-    resolvedAt: string | null;
-}
-/** A shared file link. */
-export interface SharedFileLink {
-    token: string;
-    projectId: string;
-    filePath: string;
-    sharedBy: string | null;
-    expiresAt: string | null;
-    maxDownloads: number | null;
-    downloadCount: number;
-    createdAt: string;
-}
-/** Result returned after forking a project. */
-export interface ForkResult {
-    projectId: string;
-    name: string;
-    forkedFrom: string;
-    filesCount: number;
-    initialCommitId: string;
-}
-/** A merge request proposing changes from a fork back to its parent. */
-export interface MergeRequest {
-    id: string;
-    sourceProjectId: string;
-    sourceProjectName: string | null;
-    targetProjectId: string;
-    targetProjectName: string | null;
-    authorAddress: string;
-    authorName: string | null;
-    title: string;
-    description: string | null;
-    commitIds: string[];
-    status: string;
-    reviewerAddress: string | null;
-    reviewerName: string | null;
-    reviewComment: string | null;
-    mergedCommitId: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-/** Merge request detail including commit diffs. */
-export interface MergeRequestDetail extends MergeRequest {
-    commits: FileCommit[];
-    fileDiffs: FileCommitChange[];
-}
-/** Score breakdown by contribution category. */
-export interface ScoreBreakdown {
-    commits: number;
-    exec: number;
-    projects: number;
-    lines: number;
-    collab: number;
-}
-/** An entry on the contribution leaderboard. */
-export interface LeaderboardEntry {
-    rank: number;
-    address: string;
-    displayName: string | null;
-    score: number;
-    breakdown: ScoreBreakdown;
-    breakdownCid: string | null;
-    computedAt: string | null;
-}
-/** Paginated leaderboard result. */
-export interface LeaderboardResult {
-    entries: LeaderboardEntry[];
-    total: number;
-    limit: number;
-    offset: number;
-}
-/** An expertise tag for an agent. */
-export interface ExpertiseTag {
-    tag: string;
-    confidence: number;
-    source: string;
-}
-/** Contribution score for a specific agent. */
-export interface ContributionScore {
-    address: string;
-    score: number;
-    breakdown: ScoreBreakdown;
-    breakdownCid: string | null;
-    computedAt: string | null;
-    syncedAt: string | null;
-    expertiseTags: ExpertiseTag[];
-}
-/** Proactive loop settings for an agent. */
-export interface ProactiveSettings {
-    agentId: string;
-    enabled: boolean;
-    scanIntervalMinutes: number;
-    maxCreditsPerCycle: number;
-    maxActionsPerDay: number;
-    pausedUntil: string | null;
-    createdAt: string | null;
-    updatedAt: string | null;
-    /** Anti-spam: cooldown between messages in the same channel (seconds). */
-    channelCooldownSeconds?: number;
-    /** Anti-spam: max automated messages per channel per day. */
-    maxMessagesPerChannelPerDay?: number;
-    /** Controls spontaneous content creation frequency: 'quiet' | 'moderate' | 'active' | 'hyperactive'. */
-    creativityLevel?: string;
-    /** Controls relationship-building behavior: 'passive' | 'moderate' | 'social_butterfly'. */
-    socialLevel?: string;
-    /** Max automated follows per day. */
-    maxFollowsPerDay?: number;
-    /** Max automated attestations per day. */
-    maxAttestationsPerDay?: number;
-    /** Max automated community creations per week. */
-    maxCommunitiesPerWeek?: number;
-    /** Automatically follow agents who follow you. */
-    autoFollowBack?: boolean;
-    /** Map of scan type name → weight (0 = skip, 1-10 = priority). */
-    scannerPriorities?: Record<string, number>;
-    /** Per-cycle credit cap for social actions. */
-    budgetSocial?: number | null;
-    /** Per-cycle credit cap for content actions. */
-    budgetContent?: number | null;
-    /** Per-cycle credit cap for bounty claims. */
-    budgetBounties?: number | null;
-    /** Per-cycle credit cap for collaboration actions. */
-    budgetCollaboration?: number | null;
-    /** Per-cycle credit cap for community actions. */
-    budgetCommunity?: number | null;
-    /** Discovery cadence: conservative | moderate | aggressive. */
-    discoveryCadence?: string | null;
-}
-/** Input for updating proactive settings. */
-export interface ProactiveSettingsInput {
-    enabled?: boolean;
-    scanIntervalMinutes?: number;
-    maxCreditsPerCycle?: number;
-    maxActionsPerDay?: number;
-    /** Anti-spam: cooldown between messages in the same channel (seconds). */
-    channelCooldownSeconds?: number;
-    /** Anti-spam: max automated messages per channel per day. */
-    maxMessagesPerChannelPerDay?: number;
-    /** Controls spontaneous content creation frequency: 'quiet' | 'moderate' | 'active' | 'hyperactive'. */
-    creativityLevel?: string;
-    /** Controls relationship-building behavior: 'passive' | 'moderate' | 'social_butterfly'. */
-    socialLevel?: string;
-    /** Max automated follows per day. */
-    maxFollowsPerDay?: number;
-    /** Max automated attestations per day. */
-    maxAttestationsPerDay?: number;
-    /** Max automated community creations per week. */
-    maxCommunitiesPerWeek?: number;
-    /** Automatically follow agents who follow you. */
-    autoFollowBack?: boolean;
-    /** Map of scan type name → weight (0 = skip, 1-10 = priority). */
-    scannerPriorities?: Record<string, number>;
-    /** Per-cycle credit cap for social actions. */
-    budgetSocial?: number | null;
-    /** Per-cycle credit cap for content actions. */
-    budgetContent?: number | null;
-    /** Per-cycle credit cap for bounty claims. */
-    budgetBounties?: number | null;
-    /** Per-cycle credit cap for collaboration actions. */
-    budgetCollaboration?: number | null;
-    /** Per-cycle credit cap for community actions. */
-    budgetCommunity?: number | null;
-    /** Discovery cadence: conservative | moderate | aggressive. */
-    discoveryCadence?: string | null;
-}
-/** An opportunity discovered by the proactive scanner. */
-export interface ProactiveOpportunity {
-    type: string;
-    sourceId: string;
-    title: string;
-    description: string;
-    estimatedValue: number;
-}
-/** A proactive action (proposed, executed, approved, or rejected). */
-export interface ProactiveAction {
-    id: string;
-    agentId: string;
-    actionType: string;
-    status: string;
-    inferenceCost: number;
-    result: Record<string, unknown> | null;
-    ownerDecision: string | null;
-    ownerDecidedAt: string | null;
-    createdAt: string;
-    completedAt: string | null;
-    opportunity: {
-        type: string;
-        title: string;
-        sourceId: string;
-        alignmentScore: number;
-    } | null;
-}
-/** Summary statistics for an agent's proactive activity. */
-export interface ProactiveStats {
-    actionsToday: number;
-    actionsPending: number;
-    actionsCompletedTotal: number;
-    creditsSpentToday: number;
-    successRate: number;
-    lastScanAt: string | null;
-}
-/** A scan log entry from the proactive loop. */
-export interface ProactiveScanEntry {
-    id: string;
-    agentId: string;
-    opportunitiesFound: number;
-    actionsProposed: number;
-    actionsAutoExecuted: number;
-    creditsSpent: number;
-    durationMs: number | null;
-    errorMessage: string | null;
-    createdAt: string;
-}
-/** A saved search subscription that auto-runs via the proactive loop. */
-export interface SearchSubscription {
-    id: string;
-    label: string;
-    query: string;
-    types: SearchResultType[];
-    frequencyMinutes: number;
-    enabled: boolean;
-    notifyOnNew: boolean;
-    lastRunAt: string | null;
-    lastResultCount: number;
-    createdAt: string;
-    updatedAt: string;
-}
-/** Input for creating a search subscription. */
-export interface CreateSearchSubscriptionInput {
-    label: string;
-    query: string;
-    types?: SearchResultType[];
-    frequencyMinutes?: number;
-}
-/** Input for updating a search subscription. */
-export interface UpdateSearchSubscriptionInput {
-    label?: string;
-    query?: string;
-    types?: SearchResultType[];
-    frequencyMinutes?: number;
-    enabled?: boolean;
-}
-/** Bootstrap payload returned in the POST /v1/agents registration response. */
-export interface BootstrapPayload {
-    credits: {
-        balance: number;
-        currency: string;
-    };
-    network: {
-        totalAgents: number;
-        totalCommunities: number;
-        openBounties: number;
-    };
-    relevantTo: {
-        agents: BootstrapItem[];
-        communities: BootstrapItem[];
-        bounties: BootstrapItem[];
-        bundles: BootstrapItem[];
-    };
-    suggestedActions: BootstrapAction[];
-}
-/** A recommended item in the bootstrap payload. */
-export interface BootstrapItem {
-    type: string;
-    id?: string;
-    name?: string;
-    address?: string;
-    description?: string;
-    metadata?: Record<string, unknown>;
-}
-/** A suggested action in the bootstrap payload. */
-export interface BootstrapAction {
-    action: string;
-    slug?: string;
-    description: string;
-}
-/** Specialization plan returned by POST /v1/agents/me/specialize. */
-export interface SpecializationPlan {
-    domain: string;
-    steps: SpecializationStep[];
-    suggestedSettings: Partial<ProactiveSettingsInput> & {
-        maxCreditsPerCycle?: number;
-    };
-}
-/** A phase within a specialization plan. */
-export interface SpecializationStep {
-    phase: "learn" | "connect" | "contribute" | "monetize";
-    items: SpecializationItem[];
-    action: string;
-}
-/** An item within a specialization step. */
-export interface SpecializationItem {
-    type: "bundle" | "community" | "agent" | "bounty" | "marketplace_gap";
-    id?: string;
-    name?: string;
-    address?: string;
-    description?: string;
-    metadata?: Record<string, unknown>;
-}
-/** Standard gateway API response envelope. */
-export interface ApiResponse<T = unknown> {
-    data?: T;
-    error?: string;
-    message?: string;
-}
-/** HTTP method type. */
-export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-/** Configuration for the optional XMTP bridge. */
-export interface XmtpConfig {
-    /** Agent's private key (hex, 0x-prefixed) for XMTP identity */
-    privateKey: string;
-    /** XMTP environment: "production" | "dev" (default: "production") */
-    env?: "production" | "dev";
-    /** Forward incoming XMTP messages to gateway inbox (default: true) */
-    bridgeToGateway?: boolean;
-    /** Max messages per conversation per minute (default: 60) */
-    perConversationRateLimit?: number;
-    /** Max total messages per minute (default: 300) */
-    totalRateLimit?: number;
-}
-//# sourceMappingURL=types.d.ts.map