Node.js SDK · HALO Docs

Node.js SDK 提供显式记忆助手、旧版路由器标头、和 x402 支付实用程序，用于受信任的 JavaScript 和 TypeScript 运行时。

#安装

npm install agihalo-node-sdk ethers

#身份验证和 OAuth

import { createClient } from "agihalo-node-sdk/auth";
import { HaloOAuthClient } from "agihalo-node-sdk";

// OEM or application user Authentication.
const halo = createClient(
  "https://api.agihalo.com",
  HALO_PROJECT_PUBLISHABLE_KEY
);
const { data, error } = await halo.auth.signInWithPassword({
  email: "user@example.com",
  password: "Secret123!",
});
if (error) throw error;
const { data: user } = await halo.auth.getUser();

// Service-side OAuth App client.
const oauth = new HaloOAuthClient({
  clientId: "halo_client_...",
  clientSecret: HALO_OAUTH_CLIENT_SECRET,
});

const tokens = await oauth.exchangeCode(
  callbackCode,
  "https://service.example.com/callback"
);

createClient(...).auth uses a Project publishable key for application-user signup, managed password sessions, refresh rotation, user lookup, password recovery, and upstream provider PKCE flows.HaloOAuthClient is for Services registered as OAuth Apps. The OAuth App client does not store returned tokens.

#记忆客户端

import { HaloMemoryClient } from "agihalo-node-sdk";

const memory = new HaloMemoryClient({
  apiKey: process.env.HALO_API_KEY!,
  projectKey: "customer-product",
});

const declaration = memory.functionDeclaration();

const result = await memory.executeRetrieveFunction({
  endUserKey: "user_123",
  sessionData: {
    messages: [
      { role: "user", content: "What are my report preferences?" },
    ],
  },
  limit: 5,
});

// Feed result.functionResponse to your model, then capture the final answer.
await memory.capture({
  endUserKey: "user_123",
  sessionData: {
    messages: [
      { role: "user", content: "What are my report preferences?" },
    ],
  },
  response: {
    role: "assistant",
    content: "You prefer concise reports in the morning.",
  },
});

#记忆删除

await memory.deleteTopic({
  endUserKey: "user_123",
  topicKey: "report_preferences",
  includeRaw: false,
});

await memory.deleteRawEntry({
  endUserKey: "user_123",
  rawEntryId: "raw_entry_id",
});

#关联帐户

await memory.registerOAuthProvider({
  providerKey: "google",
  clientId: GOOGLE_CLIENT_ID,
  clientSecret: GOOGLE_CLIENT_SECRET,
  redirectUri:
    "https://connect.example.com/api/v1/memory/oauth/callback/google",
});

const result = await memory.startOAuth({
  scopeId: "memory-scope-uuid",
  connectorId: "google.calendar",
  completionMode: "mobile_deep_link",
  returnUri: "example-app://oauth/complete",
});

#付款助手

使用 haloSystem 用于自动 402 重试包装程序或HaloPaymentTools （当代理必须明确决定并签名时）。

import { HaloPaymentTools } from "agihalo-node-sdk";

const tools = new HaloPaymentTools({
  privateKey: secureWalletPrivateKey,
  apiKey: HALO_API_KEY,
  haloUrl: "https://api.agihalo.com",
});

const decision = await tools.consultJudge(context, "1.00 USDC");
const signature = await tools.signPayment(paymentRequirement);