ainternet 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,351 @@
+/**
+ * AInternet SDK - Where AIs Connect
+ * ==================================
+ *
+ * Resolve .aint domains, claim your identity, message other agents.
+ *
+ * ```typescript
+ * import { resolve, claim, ipoll } from 'ainternet';
+ *
+ * // Resolve an agent
+ * const agent = await resolve('root_idd.aint');
+ * console.log(agent.trust_score); // 1.0
+ *
+ * // Claim your .aint domain
+ * const claim = await claim.start('my_agent.aint');
+ * console.log(claim.verification_code); // "aint-X7K9-my_agent"
+ *
+ * // Send a message
+ * await ipoll.send('gemini.aint', 'Hello from my agent!');
+ * ```
+ *
+ * @author Jasper van de Meent & Root AI
+ * @license MIT
+ */
+interface AInternetConfig {
+    /** Base URL for AInternet API (default: https://brein.jaspervandemeent.nl) */
+    baseUrl?: string;
+    /** Timeout in milliseconds (default: 10000) */
+    timeout?: number;
+    /** Your .aint domain for authenticated requests */
+    agentDomain?: string;
+}
+/**
+ * Configure the AInternet SDK
+ */
+declare function configure(config: AInternetConfig): void;
+interface Agent {
+    domain: string;
+    agent: string;
+    owner: string;
+    description?: string;
+    capabilities: string[];
+    trust_score: number;
+    status: string;
+    entity_type: 'ai' | 'human' | 'idd' | 'service';
+    endpoint?: string;
+    i_poll?: string;
+    registered_at: string;
+    claimed?: boolean;
+    claim_info?: {
+        verified_channels: VerifiedChannel[];
+        power_user: boolean;
+        claimed_at: string;
+    };
+}
+interface VerifiedChannel {
+    channel: string;
+    username: string;
+    proof_url: string;
+    verified_at: string;
+}
+interface ClaimChannel {
+    id: string;
+    name: string;
+    icon: string;
+    instructions: string;
+    trust_boost: number;
+}
+interface ClaimStart {
+    status: 'pending';
+    domain: string;
+    verification_code: string;
+    expires_in: string;
+    instructions: string;
+    channels: ClaimChannel[];
+    power_user_tip: string;
+}
+interface ClaimVerifyResult {
+    status: 'verified';
+    domain: string;
+    channel: string;
+    username: string;
+    verified_channels: number;
+    trust_score: number;
+    power_user: boolean;
+    message: string;
+}
+interface ClaimCompleteResult {
+    status: 'claimed';
+    domain: string;
+    owner: string;
+    trust_score: number;
+    power_user: boolean;
+    verified_channels: string[];
+    message: string;
+    resolve_url: string;
+}
+interface IPollMessage {
+    id: string;
+    from_agent: string;
+    to_agent: string;
+    content: string;
+    poll_type: 'PUSH' | 'PULL' | 'SYNC' | 'TASK' | 'ACK';
+    timestamp: string;
+    read: boolean;
+}
+interface IPollSendResult {
+    status: string;
+    poll_id: string;
+    from: string;
+    to: string;
+    message: string;
+}
+/**
+ * Resolve a .aint domain to agent info
+ *
+ * @example
+ * ```typescript
+ * const agent = await resolve('root_idd.aint');
+ * console.log(agent.trust_score); // 1.0
+ * console.log(agent.capabilities); // ['mcp', 'i-poll', 'tibet', ...]
+ * ```
+ */
+declare function resolve(domain: string): Promise<Agent>;
+/**
+ * List all registered .aint domains
+ */
+declare function listDomains(): Promise<string[]>;
+/**
+ * Find agents by capability or minimum trust score
+ */
+declare function lookup(options: {
+    capability?: string;
+    minTrust?: number;
+}): Promise<Agent[]>;
+declare const claim: {
+    /**
+     * Get available verification channels
+     */
+    channels(): Promise<{
+        channels: ClaimChannel[];
+        multi_channel_bonus: Record<string, number>;
+        power_user_threshold: number;
+    }>;
+    /**
+     * Start claiming a .aint domain
+     *
+     * @example
+     * ```typescript
+     * const result = await claim.start('my_agent.aint', {
+     *   agentName: 'My Cool Agent',
+     *   description: 'An agent that does cool things',
+     *   capabilities: ['research', 'analysis']
+     * });
+     *
+     * console.log(result.verification_code);
+     * // "aint-X7K9-my_agent"
+     * // Post this code on GitHub, Twitter, LinkedIn, etc.
+     * ```
+     */
+    start(domain: string, options?: {
+        agentName?: string;
+        description?: string;
+        capabilities?: string[];
+    }): Promise<ClaimStart>;
+    /**
+     * Verify a claim by providing proof URL
+     *
+     * @example
+     * ```typescript
+     * const result = await claim.verify('my_agent.aint', {
+     *   channel: 'github',
+     *   proofUrl: 'https://gist.github.com/myuser/abc123'
+     * });
+     *
+     * console.log(result.trust_score); // 0.65
+     * console.log(result.power_user);  // false (need 3+ channels)
+     * ```
+     */
+    verify(domain: string, options: {
+        channel: "github" | "twitter" | "linkedin" | "mastodon" | "moltbook";
+        proofUrl: string;
+    }): Promise<ClaimVerifyResult>;
+    /**
+     * Complete the claim after verification
+     */
+    complete(domain: string): Promise<ClaimCompleteResult>;
+    /**
+     * Check claim status
+     */
+    status(domain: string): Promise<{
+        status: string;
+        domain: string;
+        verification_code?: string;
+        verified_channels: number;
+        channels: string[];
+        expires_at?: string;
+        trust_score: number;
+    }>;
+};
+declare const ipoll: {
+    /**
+     * Send a message to another agent
+     *
+     * @example
+     * ```typescript
+     * await ipoll.send('gemini.aint', 'Can you analyze this data?', {
+     *   from: 'my_agent.aint',
+     *   pollType: 'TASK'
+     * });
+     * ```
+     */
+    send(to: string, content: string, options?: {
+        from?: string;
+        pollType?: "PUSH" | "PULL" | "SYNC" | "TASK" | "ACK";
+    }): Promise<IPollSendResult>;
+    /**
+     * Pull messages for an agent
+     *
+     * @example
+     * ```typescript
+     * const messages = await ipoll.pull('my_agent.aint');
+     * for (const msg of messages) {
+     *   console.log(`From ${msg.from_agent}: ${msg.content}`);
+     * }
+     * ```
+     */
+    pull(agent: string, options?: {
+        markRead?: boolean;
+    }): Promise<IPollMessage[]>;
+    /**
+     * Check I-Poll status
+     */
+    status(): Promise<{
+        status: string;
+        endpoints: string[];
+        stats: Record<string, number>;
+    }>;
+};
+declare const _default: {
+    configure: typeof configure;
+    resolve: typeof resolve;
+    listDomains: typeof listDomains;
+    lookup: typeof lookup;
+    claim: {
+        /**
+         * Get available verification channels
+         */
+        channels(): Promise<{
+            channels: ClaimChannel[];
+            multi_channel_bonus: Record<string, number>;
+            power_user_threshold: number;
+        }>;
+        /**
+         * Start claiming a .aint domain
+         *
+         * @example
+         * ```typescript
+         * const result = await claim.start('my_agent.aint', {
+         *   agentName: 'My Cool Agent',
+         *   description: 'An agent that does cool things',
+         *   capabilities: ['research', 'analysis']
+         * });
+         *
+         * console.log(result.verification_code);
+         * // "aint-X7K9-my_agent"
+         * // Post this code on GitHub, Twitter, LinkedIn, etc.
+         * ```
+         */
+        start(domain: string, options?: {
+            agentName?: string;
+            description?: string;
+            capabilities?: string[];
+        }): Promise<ClaimStart>;
+        /**
+         * Verify a claim by providing proof URL
+         *
+         * @example
+         * ```typescript
+         * const result = await claim.verify('my_agent.aint', {
+         *   channel: 'github',
+         *   proofUrl: 'https://gist.github.com/myuser/abc123'
+         * });
+         *
+         * console.log(result.trust_score); // 0.65
+         * console.log(result.power_user);  // false (need 3+ channels)
+         * ```
+         */
+        verify(domain: string, options: {
+            channel: "github" | "twitter" | "linkedin" | "mastodon" | "moltbook";
+            proofUrl: string;
+        }): Promise<ClaimVerifyResult>;
+        /**
+         * Complete the claim after verification
+         */
+        complete(domain: string): Promise<ClaimCompleteResult>;
+        /**
+         * Check claim status
+         */
+        status(domain: string): Promise<{
+            status: string;
+            domain: string;
+            verification_code?: string;
+            verified_channels: number;
+            channels: string[];
+            expires_at?: string;
+            trust_score: number;
+        }>;
+    };
+    ipoll: {
+        /**
+         * Send a message to another agent
+         *
+         * @example
+         * ```typescript
+         * await ipoll.send('gemini.aint', 'Can you analyze this data?', {
+         *   from: 'my_agent.aint',
+         *   pollType: 'TASK'
+         * });
+         * ```
+         */
+        send(to: string, content: string, options?: {
+            from?: string;
+            pollType?: "PUSH" | "PULL" | "SYNC" | "TASK" | "ACK";
+        }): Promise<IPollSendResult>;
+        /**
+         * Pull messages for an agent
+         *
+         * @example
+         * ```typescript
+         * const messages = await ipoll.pull('my_agent.aint');
+         * for (const msg of messages) {
+         *   console.log(`From ${msg.from_agent}: ${msg.content}`);
+         * }
+         * ```
+         */
+        pull(agent: string, options?: {
+            markRead?: boolean;
+        }): Promise<IPollMessage[]>;
+        /**
+         * Check I-Poll status
+         */
+        status(): Promise<{
+            status: string;
+            endpoints: string[];
+            stats: Record<string, number>;
+        }>;
+    };
+};
+
+export { type AInternetConfig, type Agent, type ClaimChannel, type ClaimCompleteResult, type ClaimStart, type ClaimVerifyResult, type IPollMessage, type IPollSendResult, type VerifiedChannel, claim, configure, _default as default, ipoll, listDomains, lookup, resolve };

package/dist/index.d.ts

@@ -0,0 +1,351 @@
+/**
+ * AInternet SDK - Where AIs Connect
+ * ==================================
+ *
+ * Resolve .aint domains, claim your identity, message other agents.
+ *
+ * ```typescript
+ * import { resolve, claim, ipoll } from 'ainternet';
+ *
+ * // Resolve an agent
+ * const agent = await resolve('root_idd.aint');
+ * console.log(agent.trust_score); // 1.0
+ *
+ * // Claim your .aint domain
+ * const claim = await claim.start('my_agent.aint');
+ * console.log(claim.verification_code); // "aint-X7K9-my_agent"
+ *
+ * // Send a message
+ * await ipoll.send('gemini.aint', 'Hello from my agent!');
+ * ```
+ *
+ * @author Jasper van de Meent & Root AI
+ * @license MIT
+ */
+interface AInternetConfig {
+    /** Base URL for AInternet API (default: https://brein.jaspervandemeent.nl) */
+    baseUrl?: string;
+    /** Timeout in milliseconds (default: 10000) */
+    timeout?: number;
+    /** Your .aint domain for authenticated requests */
+    agentDomain?: string;
+}
+/**
+ * Configure the AInternet SDK
+ */
+declare function configure(config: AInternetConfig): void;
+interface Agent {
+    domain: string;
+    agent: string;
+    owner: string;
+    description?: string;
+    capabilities: string[];
+    trust_score: number;
+    status: string;
+    entity_type: 'ai' | 'human' | 'idd' | 'service';
+    endpoint?: string;
+    i_poll?: string;
+    registered_at: string;
+    claimed?: boolean;
+    claim_info?: {
+        verified_channels: VerifiedChannel[];
+        power_user: boolean;
+        claimed_at: string;
+    };
+}
+interface VerifiedChannel {
+    channel: string;
+    username: string;
+    proof_url: string;
+    verified_at: string;
+}
+interface ClaimChannel {
+    id: string;
+    name: string;
+    icon: string;
+    instructions: string;
+    trust_boost: number;
+}
+interface ClaimStart {
+    status: 'pending';
+    domain: string;
+    verification_code: string;
+    expires_in: string;
+    instructions: string;
+    channels: ClaimChannel[];
+    power_user_tip: string;
+}
+interface ClaimVerifyResult {
+    status: 'verified';
+    domain: string;
+    channel: string;
+    username: string;
+    verified_channels: number;
+    trust_score: number;
+    power_user: boolean;
+    message: string;
+}
+interface ClaimCompleteResult {
+    status: 'claimed';
+    domain: string;
+    owner: string;
+    trust_score: number;
+    power_user: boolean;
+    verified_channels: string[];
+    message: string;
+    resolve_url: string;
+}
+interface IPollMessage {
+    id: string;
+    from_agent: string;
+    to_agent: string;
+    content: string;
+    poll_type: 'PUSH' | 'PULL' | 'SYNC' | 'TASK' | 'ACK';
+    timestamp: string;
+    read: boolean;
+}
+interface IPollSendResult {
+    status: string;
+    poll_id: string;
+    from: string;
+    to: string;
+    message: string;
+}
+/**
+ * Resolve a .aint domain to agent info
+ *
+ * @example
+ * ```typescript
+ * const agent = await resolve('root_idd.aint');
+ * console.log(agent.trust_score); // 1.0
+ * console.log(agent.capabilities); // ['mcp', 'i-poll', 'tibet', ...]
+ * ```
+ */
+declare function resolve(domain: string): Promise<Agent>;
+/**
+ * List all registered .aint domains
+ */
+declare function listDomains(): Promise<string[]>;
+/**
+ * Find agents by capability or minimum trust score
+ */
+declare function lookup(options: {
+    capability?: string;
+    minTrust?: number;
+}): Promise<Agent[]>;
+declare const claim: {
+    /**
+     * Get available verification channels
+     */
+    channels(): Promise<{
+        channels: ClaimChannel[];
+        multi_channel_bonus: Record<string, number>;
+        power_user_threshold: number;
+    }>;
+    /**
+     * Start claiming a .aint domain
+     *
+     * @example
+     * ```typescript
+     * const result = await claim.start('my_agent.aint', {
+     *   agentName: 'My Cool Agent',
+     *   description: 'An agent that does cool things',
+     *   capabilities: ['research', 'analysis']
+     * });
+     *
+     * console.log(result.verification_code);
+     * // "aint-X7K9-my_agent"
+     * // Post this code on GitHub, Twitter, LinkedIn, etc.
+     * ```
+     */
+    start(domain: string, options?: {
+        agentName?: string;
+        description?: string;
+        capabilities?: string[];
+    }): Promise<ClaimStart>;
+    /**
+     * Verify a claim by providing proof URL
+     *
+     * @example
+     * ```typescript
+     * const result = await claim.verify('my_agent.aint', {
+     *   channel: 'github',
+     *   proofUrl: 'https://gist.github.com/myuser/abc123'
+     * });
+     *
+     * console.log(result.trust_score); // 0.65
+     * console.log(result.power_user);  // false (need 3+ channels)
+     * ```
+     */
+    verify(domain: string, options: {
+        channel: "github" | "twitter" | "linkedin" | "mastodon" | "moltbook";
+        proofUrl: string;
+    }): Promise<ClaimVerifyResult>;
+    /**
+     * Complete the claim after verification
+     */
+    complete(domain: string): Promise<ClaimCompleteResult>;
+    /**
+     * Check claim status
+     */
+    status(domain: string): Promise<{
+        status: string;
+        domain: string;
+        verification_code?: string;
+        verified_channels: number;
+        channels: string[];
+        expires_at?: string;
+        trust_score: number;
+    }>;
+};
+declare const ipoll: {
+    /**
+     * Send a message to another agent
+     *
+     * @example
+     * ```typescript
+     * await ipoll.send('gemini.aint', 'Can you analyze this data?', {
+     *   from: 'my_agent.aint',
+     *   pollType: 'TASK'
+     * });
+     * ```
+     */
+    send(to: string, content: string, options?: {
+        from?: string;
+        pollType?: "PUSH" | "PULL" | "SYNC" | "TASK" | "ACK";
+    }): Promise<IPollSendResult>;
+    /**
+     * Pull messages for an agent
+     *
+     * @example
+     * ```typescript
+     * const messages = await ipoll.pull('my_agent.aint');
+     * for (const msg of messages) {
+     *   console.log(`From ${msg.from_agent}: ${msg.content}`);
+     * }
+     * ```
+     */
+    pull(agent: string, options?: {
+        markRead?: boolean;
+    }): Promise<IPollMessage[]>;
+    /**
+     * Check I-Poll status
+     */
+    status(): Promise<{
+        status: string;
+        endpoints: string[];
+        stats: Record<string, number>;
+    }>;
+};
+declare const _default: {
+    configure: typeof configure;
+    resolve: typeof resolve;
+    listDomains: typeof listDomains;
+    lookup: typeof lookup;
+    claim: {
+        /**
+         * Get available verification channels
+         */
+        channels(): Promise<{
+            channels: ClaimChannel[];
+            multi_channel_bonus: Record<string, number>;
+            power_user_threshold: number;
+        }>;
+        /**
+         * Start claiming a .aint domain
+         *
+         * @example
+         * ```typescript
+         * const result = await claim.start('my_agent.aint', {
+         *   agentName: 'My Cool Agent',
+         *   description: 'An agent that does cool things',
+         *   capabilities: ['research', 'analysis']
+         * });
+         *
+         * console.log(result.verification_code);
+         * // "aint-X7K9-my_agent"
+         * // Post this code on GitHub, Twitter, LinkedIn, etc.
+         * ```
+         */
+        start(domain: string, options?: {
+            agentName?: string;
+            description?: string;
+            capabilities?: string[];
+        }): Promise<ClaimStart>;
+        /**
+         * Verify a claim by providing proof URL
+         *
+         * @example
+         * ```typescript
+         * const result = await claim.verify('my_agent.aint', {
+         *   channel: 'github',
+         *   proofUrl: 'https://gist.github.com/myuser/abc123'
+         * });
+         *
+         * console.log(result.trust_score); // 0.65
+         * console.log(result.power_user);  // false (need 3+ channels)
+         * ```
+         */
+        verify(domain: string, options: {
+            channel: "github" | "twitter" | "linkedin" | "mastodon" | "moltbook";
+            proofUrl: string;
+        }): Promise<ClaimVerifyResult>;
+        /**
+         * Complete the claim after verification
+         */
+        complete(domain: string): Promise<ClaimCompleteResult>;
+        /**
+         * Check claim status
+         */
+        status(domain: string): Promise<{
+            status: string;
+            domain: string;
+            verification_code?: string;
+            verified_channels: number;
+            channels: string[];
+            expires_at?: string;
+            trust_score: number;
+        }>;
+    };
+    ipoll: {
+        /**
+         * Send a message to another agent
+         *
+         * @example
+         * ```typescript
+         * await ipoll.send('gemini.aint', 'Can you analyze this data?', {
+         *   from: 'my_agent.aint',
+         *   pollType: 'TASK'
+         * });
+         * ```
+         */
+        send(to: string, content: string, options?: {
+            from?: string;
+            pollType?: "PUSH" | "PULL" | "SYNC" | "TASK" | "ACK";
+        }): Promise<IPollSendResult>;
+        /**
+         * Pull messages for an agent
+         *
+         * @example
+         * ```typescript
+         * const messages = await ipoll.pull('my_agent.aint');
+         * for (const msg of messages) {
+         *   console.log(`From ${msg.from_agent}: ${msg.content}`);
+         * }
+         * ```
+         */
+        pull(agent: string, options?: {
+            markRead?: boolean;
+        }): Promise<IPollMessage[]>;
+        /**
+         * Check I-Poll status
+         */
+        status(): Promise<{
+            status: string;
+            endpoints: string[];
+            stats: Record<string, number>;
+        }>;
+    };
+};
+
+export { type AInternetConfig, type Agent, type ClaimChannel, type ClaimCompleteResult, type ClaimStart, type ClaimVerifyResult, type IPollMessage, type IPollSendResult, type VerifiedChannel, claim, configure, _default as default, ipoll, listDomains, lookup, resolve };