@hostfunc/sdk

Production SDK for hostfunc functions.

Modules

• @hostfunc/sdk - core function APIs (executeFunction, secret)
• @hostfunc/sdk/ai - AI helpers (askAi, streamAi, createEmbedding)
• @hostfunc/sdk/agent - agent orchestration (createAgent, runAgent)
• @hostfunc/sdk/vector - vector operations (upsert, query, deleteVectors, getNamespace)

Core Usage

import fn, { secret } from "@hostfunc/sdk";

export async function main(input: { customerId: string }) {
  const apiKey = await secret.getRequired("CLAUDE_API_KEY");
  const report = await fn.executeFunction("org/generate-report", {
    customerId: input.customerId,
    apiKey,
  });
  return report;
}

AI Usage

import { askAi } from "@hostfunc/sdk/ai";

const summary = await askAi("Summarize this execution log.");

Agent Usage

import { runAgent } from "@hostfunc/sdk/agent";

const run = await runAgent({
  name: "triage-alerts",
  goal: "Classify incident events and call escalation functions.",
});

Vector Usage

import { createEmbedding } from "@hostfunc/sdk/ai";
import { upsert, query } from "@hostfunc/sdk/vector";

const { embedding } = await createEmbedding("customer profile text");
await upsert("profiles", [{ id: "cus_123", values: embedding }]);
const hits = await query("profiles", embedding, { topK: 5 });