Files

Most agents should use profile.read(), profile.search(), profile.remember(), and profile.commit().

Raw profile file operations are an advanced escape hatch under configure.files.*:

const file = await configure.files.read({
  externalId: "customer-123",
  path: "/preferences.md",
});

await configure.files.write({
  externalId: "customer-123",
  path: "/agents/your-agent/preferences.md",
  content: "Prefers concise replies.",
  mode: "append",
});

Available file operations:

• configure.files.list({ externalId, path })
• configure.files.read({ externalId, path })
• configure.files.write({ externalId, path, content, mode })
• configure.files.search({ externalId, query, path })
• configure.files.delete({ externalId, path })

File paths are not accepted by profile.read() or profile.search().