@andreprado/agentkit 0.1.1 → 0.2.0

package/src/cloud/client.ts

@@ -1,80 +0,0 @@
-import { chmod, mkdir, writeFile } from "node:fs/promises";
-import { join } from "node:path";
-
-import type { AgentBuildResult } from "../runtime/targets/cloudflare/build";
-import type { LocalDeployState } from "../runtime/core/deploy-state";
-import { AgentKitError } from "../runtime/errors";
-import { createHostedDeployArtifact } from "./artifact";
-import type { AgentKitCloudDeployOptions, CreateDeployRequest, CreateDeployResponse } from "./contracts";
-
-export async function deployBuildToAgentKitCloud(
-  build: AgentBuildResult,
-  options: AgentKitCloudDeployOptions,
-): Promise<CreateDeployResponse> {
-  const artifact = await createHostedDeployArtifact(build);
-  const headers = new Headers({
-    "Content-Type": "application/json",
-  });
-  const apiToken = options.anonymous ? undefined : options.apiToken ?? process.env.AGENTKIT_CLOUD_API_TOKEN;
-
-  if (apiToken) {
-    headers.set("Authorization", `Bearer ${apiToken}`);
-  }
-
-  const response = await fetch(new URL("/v1/deploys", normalizeApiUrl(options.apiUrl)), {
-    method: "POST",
-    headers,
-    body: JSON.stringify({
-      project_name: artifact.manifest.name,
-      anonymous: options.anonymous ?? !apiToken,
-      artifact,
-    } satisfies CreateDeployRequest),
-  });
-  const payload = await response.json().catch(() => null);
-
-  if (!response.ok) {
-    const code =
-      payload && typeof payload === "object" && "error" in payload
-        ? String((payload as { error?: { code?: unknown } }).error?.code ?? "cloud_deploy_failed")
-        : "cloud_deploy_failed";
-    const message =
-      payload && typeof payload === "object" && "error" in payload
-        ? String((payload as { error?: { message?: unknown } }).error?.message ?? "AgentKit Cloud deploy failed.")
-        : `AgentKit Cloud deploy failed with HTTP ${response.status}.`;
-    throw new AgentKitError(code, message);
-  }
-
-  return payload as CreateDeployResponse;
-}
-
-export async function writeLocalDeployState(root: string, deploy: CreateDeployResponse): Promise<string> {
-  const statePath = join(root, ".agentkit/deploy.json");
-  const state: LocalDeployState = {
-    project_id: deploy.project.id,
-    deploy_id: deploy.deploy.id,
-    url: deploy.deploy.url,
-    target: "cloudflare",
-    runtime: "edge",
-    resources: {
-      cloudflare: {
-        worker_url: deploy.deploy.url,
-        durable_object_class: "AgentKitConversationStore",
-      },
-    },
-    owner_state: deploy.project.owner_state,
-    access: {
-      mode: deploy.deploy.access.mode,
-      private_token: deploy.deploy.access.private_token ?? undefined,
-    },
-    created_at: new Date().toISOString(),
-  };
-
-  await mkdir(join(root, ".agentkit"), { recursive: true });
-  await writeFile(statePath, `${JSON.stringify(state, null, 2)}\n`, { mode: 0o600 });
-  await chmod(statePath, 0o600);
-  return statePath;
-}
-
-function normalizeApiUrl(value: string): string {
-  return value.endsWith("/") ? value : `${value}/`;
-}

package/src/cloud/contracts.ts

@@ -1,63 +0,0 @@
-import type { AgentManifestWithBundle } from "../runtime/targets/cloudflare/build";
-
-export type HostedDeployArtifact = {
-  manifest: AgentManifestWithBundle;
-  worker: {
-    content_type: "application/javascript";
-    source: string;
-    sha256: string;
-  };
-  wrangler: {
-    content_type: "application/json";
-    source: string;
-  };
-  turso_schema?: {
-    content_type: "text/sql";
-    source: string;
-    sha256: string;
-  };
-  knowledge_sources?: {
-    content_type: "application/json";
-    sources: Array<{
-      kind: "file";
-      source_key: string;
-      title: string | null;
-      content: string;
-      sha256: string;
-    }>;
-    sha256: string;
-  };
-};
-
-export type CreateDeployRequest = {
-  project_name: string;
-  anonymous: boolean;
-  artifact: HostedDeployArtifact;
-};
-
-export type CreateDeployResponse = {
-  project: {
-    id: string;
-    owner_state: "anonymous" | "claimed";
-  };
-  deploy: {
-    id: string;
-    status: "ready" | "failed";
-    url: string;
-    access: {
-      mode: string;
-      private_token?: string;
-    };
-    knowledge?: {
-      enabled: boolean;
-      sources: number;
-      chunks: number;
-    };
-  };
-};
-
-export type AgentKitCloudDeployOptions = {
-  apiUrl: string;
-  apiToken?: string | null;
-  anonymous?: boolean;
-};

package/src/cloud/index.ts

@@ -1,3 +0,0 @@
-export * from "./artifact";
-export * from "./client";
-export * from "./contracts";

package/src/runtime/build.ts

@@ -1,43 +0,0 @@
-import { resolveBuildTarget, type RuntimeTargetId } from "./core/targets";
-import { buildContainerAgentCapsule, type ContainerBuildResult } from "./targets/container/build";
-import {
-  buildCloudflareAgentCapsule,
-  type AgentBuildResult as CloudflareBuildResult,
-  type AgentManifest,
-  type AgentManifestWithBundle,
-} from "./targets/cloudflare/build";
-
-export type BuildTarget = RuntimeTargetId;
-
-export type BuildAgentOptions = {
-  target?: string;
-};
-
-export type AgentBuildResult = CloudflareBuildResult | ContainerBuildResult;
-export type { AgentManifest, AgentManifestWithBundle };
-
-export async function buildAgentCapsule(
-  cwd?: string,
-  options?: { target?: "cloudflare" },
-): Promise<CloudflareBuildResult>;
-export async function buildAgentCapsule(
-  cwd: string | undefined,
-  options: { target: "container" },
-): Promise<ContainerBuildResult>;
-export async function buildAgentCapsule(cwd?: string, options?: BuildAgentOptions): Promise<AgentBuildResult>;
-export async function buildAgentCapsule(
-  cwd = process.cwd(),
-  options: BuildAgentOptions = {},
-): Promise<AgentBuildResult> {
-  const target = resolveBuildTarget(options.target);
-
-  if (target.id === "cloudflare") {
-    return buildCloudflareAgentCapsule(cwd);
-  }
-
-  if (target.id === "container") {
-    return buildContainerAgentCapsule(cwd);
-  }
-
-  throw new Error(`Target registry returned unsupported build target "${target.id}".`);
-}

package/src/runtime/core/deploy-state.ts

@@ -1,54 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { join } from "node:path";
-
-import { findAgentCapsuleRoot } from "../config";
-import type { RuntimeTargetId } from "./targets";
-
-export type LocalDeployState = {
-  project_id?: string;
-  deploy_id: string;
-  url?: string;
-  target: RuntimeTargetId;
-  runtime: "edge" | "container";
-  resources: Record<string, unknown>;
-  owner_state?: "anonymous" | "claimed";
-  access?: {
-    mode?: string;
-    private_token?: string;
-  };
-  created_at?: string;
-};
-
-export function normalizeDeployState(input: unknown): LocalDeployState | null {
-  if (!input || typeof input !== "object") {
-    return null;
-  }
-
-  const state = input as Partial<LocalDeployState>;
-
-  if (typeof state.deploy_id !== "string" || state.deploy_id.length === 0) {
-    return null;
-  }
-
-  return {
-    ...state,
-    deploy_id: state.deploy_id,
-    target: isRuntimeTarget(state.target) ? state.target : "cloudflare",
-    runtime: state.runtime === "container" ? "container" : "edge",
-    resources: state.resources && typeof state.resources === "object" ? state.resources : {},
-  };
-}
-
-export async function readLocalDeployStateIfExists(cwd: string): Promise<LocalDeployState | null> {
-  try {
-    const root = await findAgentCapsuleRoot(cwd);
-    const source = await readFile(join(root, ".agentkit/deploy.json"), "utf8");
-    return normalizeDeployState(JSON.parse(source));
-  } catch {
-    return null;
-  }
-}
-
-function isRuntimeTarget(value: unknown): value is RuntimeTargetId {
-  return value === "local" || value === "cloudflare" || value === "container" || value === "vps";
-}

package/src/runtime/core/manifest.ts

@@ -1,283 +0,0 @@
-import { relative, resolve } from "node:path";
-
-import { AgentKitError } from "../errors";
-
-import type { AgentConfig, AgentTool } from "../../index";
-import type { LoadedAgentCapsule } from "../config";
-import {
-  createManagedComposioTools,
-  managedComposioRequiredSecrets,
-  resolveManagedComposioIntegrations,
-} from "../integrations/composio";
-import { resolveKnowledgeConfig } from "../knowledge/config";
-import { KNOWLEDGE_SEARCH_TOOL_NAME } from "../knowledge/tool";
-import { resolveTranscriptionConfig } from "../transcription";
-
-export type ManifestSchema = {
-  source: string;
-  sha256: string;
-};
-
-export type SharedAgentManifest = {
-  schema_version: 1;
-  name: string;
-  runtime: AgentConfig["runtime"];
-  provider: AgentConfig["provider"];
-  timeZone: string | null;
-  prompt: string;
-  secrets: string[];
-  tools: Array<{
-    name: string;
-    description: string;
-    inputSchema: AgentTool["inputSchema"];
-    outputSchema?: AgentTool["outputSchema"];
-    secrets: string[];
-    permissions: string[];
-    timeoutMs: number | null;
-  }>;
-  integrations: Array<{
-    name: string;
-    provider: "composio";
-    mode: "managed";
-    toolkits: string[];
-    tools: string[];
-    userId: string;
-    confirmExternalWrites: boolean;
-  }>;
-  channels: NonNullable<AgentConfig["channels"]>;
-  transcription: {
-    enabled: boolean;
-    provider: string | null;
-    model: string | null;
-    secret: string | null;
-    language: string | null;
-    prompt: string | null;
-    limits: {
-      maxDurationSeconds: number | null;
-      maxBytes: number | null;
-    };
-    rawAudioTtlSeconds: number | null;
-  };
-  knowledge: {
-    enabled: boolean;
-    sources: Array<{
-      kind: "file" | "url";
-      value: string;
-      title: string | null;
-    }>;
-    embedding: {
-      provider: string;
-      model: string | null;
-      dimensions: number | null;
-      secret: string | null;
-    };
-    retrieval: {
-      topK: number;
-      hybrid: boolean;
-    };
-    internalTool: string | null;
-  };
-  access: AgentConfig["access"];
-  storage: {
-    driver: AgentConfig["storage"]["driver"];
-    database:
-      | {
-          driver: "none";
-        }
-      | {
-          driver: "turso";
-          schema: string | null;
-          schema_sha256: string | null;
-        };
-    files:
-      | {
-          driver: "none";
-        }
-      | {
-          driver: "object";
-          bucket: string;
-          prefix: string;
-          maxUploadBytes: number;
-        };
-  };
-};
-
-export function buildSharedAgentManifest(
-  capsule: LoadedAgentCapsule,
-  options: { databaseSchema?: ManifestSchema | null } = {},
-): SharedAgentManifest {
-  if (capsule.config.provider.name === "openai-codex") {
-    throw new AgentKitError(
-      "target_runtime_incompatible",
-      "openai-codex uses a local ChatGPT login. Use agentkit dev/chat/eval locally, or select an API-key provider with managed secrets for Cloudflare, container, or VPS deployment.",
-    );
-  }
-
-  const requiredSecrets = new Set(capsule.config.secrets);
-  const database = buildDatabaseManifest(capsule, options.databaseSchema ?? null);
-  const files = buildFilesManifest(capsule);
-  const knowledge = resolveKnowledgeConfig(capsule.config);
-  const integrationTools = createManagedComposioTools(capsule.config);
-  const tools = [...integrationTools, ...(capsule.config.tools ?? [])];
-  const transcription = resolveTranscriptionConfig(capsule.config.transcription);
-
-  requiredSecrets.add("AGENTKIT_PRIVATE_TOKEN");
-
-  if (capsule.config.access.mode === "token") {
-    requiredSecrets.add("AGENTKIT_ACCESS_TOKEN");
-  }
-
-  if (capsule.config.provider.name === "openai") {
-    requiredSecrets.add("OPENAI_API_KEY");
-  }
-
-  if (database.driver === "turso") {
-    requiredSecrets.add("TURSO_DATABASE_URL");
-    requiredSecrets.add("TURSO_AUTH_TOKEN");
-  }
-
-  if (knowledge.embedding.secret) {
-    requiredSecrets.add(knowledge.embedding.secret);
-  }
-
-  if (transcription.secret) {
-    requiredSecrets.add(transcription.secret);
-  }
-
-  for (const secret of managedComposioRequiredSecrets(capsule.config)) {
-    requiredSecrets.add(secret);
-  }
-
-  for (const tool of tools) {
-    for (const secret of tool.secrets ?? []) {
-      requiredSecrets.add(secret);
-    }
-  }
-
-  for (const channel of capsule.config.channels ?? []) {
-    for (const secret of channel.secrets) {
-      requiredSecrets.add(secret);
-    }
-  }
-
-  return {
-    schema_version: 1,
-    name: capsule.config.name,
-    runtime: capsule.config.runtime,
-    provider: capsule.config.provider,
-    timeZone: capsule.config.timeZone ?? null,
-    prompt: toCapsulePath(capsule, capsule.instructionsPath),
-    secrets: Array.from(requiredSecrets).sort(),
-    tools: tools.map((tool) => ({
-      name: tool.name,
-      description: tool.description,
-      inputSchema: tool.inputSchema,
-      outputSchema: tool.outputSchema,
-      secrets: [...(tool.secrets ?? [])].sort(),
-      permissions: [...(tool.permissions ?? [])].sort(),
-      timeoutMs: tool.timeoutMs ?? null,
-    })),
-    integrations: resolveManagedComposioIntegrations(capsule.config).map((integration) => ({
-      name: integration.name,
-      provider: integration.provider,
-      mode: integration.mode,
-      toolkits: integration.toolkits,
-      tools: integration.allowedTools,
-      userId: integration.userId,
-      confirmExternalWrites: integration.confirmExternalWrites !== false,
-    })),
-    channels: capsule.config.channels ?? [],
-    transcription: {
-      enabled: transcription.enabled,
-      provider: transcription.enabled ? transcription.provider : null,
-      model: transcription.enabled ? transcription.model : null,
-      secret: transcription.secret,
-      language: transcription.language,
-      prompt: transcription.prompt,
-      limits: {
-        maxDurationSeconds: transcription.limits.maxDurationSeconds ?? null,
-        maxBytes: transcription.limits.maxBytes ?? null,
-      },
-      rawAudioTtlSeconds: transcription.rawAudioTtlSeconds,
-    },
-    knowledge: {
-      enabled: knowledge.enabled,
-      sources: knowledge.sources.map((source) => ({
-        kind: source.kind,
-        value: source.value,
-        title: source.title,
-      })),
-      embedding: knowledge.embedding,
-      retrieval: knowledge.retrieval,
-      internalTool: knowledge.enabled ? KNOWLEDGE_SEARCH_TOOL_NAME : null,
-    },
-    access: capsule.config.access,
-    storage: {
-      driver: capsule.config.storage.driver,
-      database,
-      files,
-    },
-  };
-}
-
-export function toCapsulePath(capsule: LoadedAgentCapsule, path: string): string {
-  const localPath = relative(capsule.root, path);
-  return localPath.length > 0 ? localPath : ".";
-}
-
-function buildDatabaseManifest(
-  capsule: LoadedAgentCapsule,
-  schema: ManifestSchema | null,
-): SharedAgentManifest["storage"]["database"] {
-  const database = capsule.config.storage.database;
-
-  if (!database || database.driver === "none") {
-    return { driver: "none" };
-  }
-
-  const schemaPath = database.schema ? resolve(capsule.root, database.schema) : null;
-
-  return {
-    driver: "turso",
-    schema: schemaPath ? toCapsulePath(capsule, schemaPath) : null,
-    schema_sha256: schema?.sha256 ?? null,
-  };
-}
-
-function buildFilesManifest(capsule: LoadedAgentCapsule): SharedAgentManifest["storage"]["files"] {
-  const files = capsule.config.storage.files;
-
-  if (!files || files.driver === "none") {
-    return { driver: "none" };
-  }
-
-  return {
-    driver: "object",
-    bucket: files.bucket ?? `agentkit-${slugify(capsule.config.name)}-files`,
-    prefix: normalizePrefix(files.prefix ?? capsule.config.name),
-    maxUploadBytes: files.maxUploadBytes ?? 10 * 1024 * 1024,
-  };
-}
-
-function slugify(value: string): string {
-  const slug = value
-    .toLowerCase()
-    .replace(/[^a-z0-9-]+/g, "-")
-    .replace(/^-+|-+$/g, "")
-    .slice(0, 48);
-
-  return slug || "agent";
-}
-
-function normalizePrefix(value: string): string {
-  return value
-    .split("/")
-    .map((part) =>
-      part
-        .toLowerCase()
-        .replace(/[^a-z0-9_-]+/g, "-")
-        .replace(/^-+|-+$/g, ""),
-    )
-    .filter(Boolean)
-    .join("/");
-}

package/src/runtime/core/targets.ts

@@ -1,133 +0,0 @@
-import { AgentKitError } from "../errors";
-
-export const runtimeTargetIds = ["local", "cloudflare", "container", "vps"] as const;
-
-export type RuntimeTargetId = (typeof runtimeTargetIds)[number];
-export type RuntimeTargetCapabilityState = "available" | "planned" | "unsupported";
-export type RuntimeStorageCapability = "agentkit" | "durable-object-sqlite" | "local-sqlite" | "postgres";
-export type RuntimeFilesCapability = "none" | "r2" | "local-disk" | "s3-compatible";
-export type RuntimeChannelCapability = "website" | "telegram" | "whatsapp" | "discord" | "slack" | "webhook";
-export type RuntimeProviderSupport = "pi-local" | "edge-compatible" | "server-env";
-
-export type RuntimeTargetCapabilities = {
-  build: RuntimeTargetCapabilityState;
-  deploy: RuntimeTargetCapabilityState;
-  dev: RuntimeTargetCapabilityState;
-  storage: readonly RuntimeStorageCapability[];
-  files: readonly RuntimeFilesCapability[];
-  channels: readonly RuntimeChannelCapability[];
-  providers: readonly RuntimeProviderSupport[];
-};
-
-export type RuntimeTarget = {
-  id: RuntimeTargetId;
-  label: string;
-  capabilities: RuntimeTargetCapabilities;
-};
-
-export const runtimeTargets: Readonly<Record<RuntimeTargetId, RuntimeTarget>> = {
-  local: {
-    id: "local",
-    label: "Local dev server",
-    capabilities: {
-      build: "unsupported",
-      deploy: "unsupported",
-      dev: "available",
-      storage: ["local-sqlite"],
-      files: ["local-disk"],
-      channels: ["website", "slack", "webhook"],
-      providers: ["pi-local"],
-    },
-  },
-  cloudflare: {
-    id: "cloudflare",
-    label: "Cloudflare Worker",
-    capabilities: {
-      build: "available",
-      deploy: "available",
-      dev: "planned",
-      storage: ["agentkit", "durable-object-sqlite", "postgres"],
-      files: ["none", "r2"],
-      channels: ["website", "telegram", "whatsapp", "discord", "slack", "webhook"],
-      providers: ["edge-compatible"],
-    },
-  },
-  container: {
-    id: "container",
-    label: "Container runtime",
-    capabilities: {
-      build: "available",
-      deploy: "planned",
-      dev: "planned",
-      storage: ["local-sqlite", "postgres"],
-      files: ["none", "local-disk", "s3-compatible"],
-      channels: ["website", "telegram", "whatsapp", "discord", "slack", "webhook"],
-      providers: ["server-env"],
-    },
-  },
-  vps: {
-    id: "vps",
-    label: "VPS handoff",
-    capabilities: {
-      build: "unsupported",
-      deploy: "available",
-      dev: "unsupported",
-      storage: ["local-sqlite", "postgres"],
-      files: ["none", "local-disk", "s3-compatible"],
-      channels: ["website", "telegram", "whatsapp", "discord", "slack", "webhook"],
-      providers: ["server-env"],
-    },
-  },
-};
-
-export function resolveRuntimeTarget(id: string): RuntimeTarget {
-  if (isRuntimeTargetId(id)) {
-    return runtimeTargets[id];
-  }
-
-  throw new AgentKitError(
-    "unsupported_target",
-    `Unsupported target "${id}". Supported targets: ${runtimeTargetIds.join(", ")}.`,
-  );
-}
-
-export function resolveBuildTarget(id = "cloudflare"): RuntimeTarget {
-  const target = resolveRuntimeTarget(id);
-
-  if (target.capabilities.build !== "available") {
-    throw unsupportedCapability("build", target.id, listTargetsWithCapability("build"));
-  }
-
-  return target;
-}
-
-export function resolveDeployTarget(id = "cloudflare"): RuntimeTarget {
-  const target = resolveRuntimeTarget(id);
-
-  if (target.capabilities.deploy !== "available") {
-    throw unsupportedCapability("deploy", target.id, listTargetsWithCapability("deploy"));
-  }
-
-  return target;
-}
-
-export function isRuntimeTargetId(id: string): id is RuntimeTargetId {
-  return Object.prototype.hasOwnProperty.call(runtimeTargets, id);
-}
-
-export function listTargetsWithCapability(
-  capability: "build" | "deploy" | "dev",
-): readonly RuntimeTargetId[] {
-  return runtimeTargetIds.filter((id) => runtimeTargets[id].capabilities[capability] === "available");
-}
-
-function unsupportedCapability(
-  capability: "build" | "deploy" | "dev",
-  id: RuntimeTargetId,
-  supportedTargets: readonly RuntimeTargetId[],
-): AgentKitError {
-  return new AgentKitError(
-    "unsupported_target",
-    `Unsupported ${capability} target "${id}". Supported ${capability} targets: ${supportedTargets.join(", ")}.`,
-  );
-}