polarity_dump
Record a place-anchored thought by writing a short message tied to a location waypoint into your personal knowledge graph.
Instructions
Write a short message tied to a location waypoint into the user's graph. PolarityGPS-style. Use only when the user is explicitly recording a place-anchored thought.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| waypoint_id | Yes | ||
| name | Yes | ||
| lat | No | ||
| lon | No | ||
| message | Yes |
Implementation Reference
- src/client/cosmos.ts:115-121 (handler)The dump() method on CosmosClient sends a POST to /api/polarity/dump with waypoint_id, name, lat, lon, and message to record a location-anchored thought.
dump(input: { waypoint_id: string; name: string; lat?: number; lon?: number; message: string }) { return this.request<DumpResponse>({ method: "POST", path: "/api/polarity/dump", body: { polarity_user_id: this.config.polarityUserId, ...input }, }); } - src/client/cosmos.ts:232-237 (schema)The DumpResponse interface defining the shape returned by the dump API: cosmos_user_id, location_node_id, message_node_id, edge_id.
export interface DumpResponse { cosmos_user_id: number; location_node_id: number; message_node_id: number; edge_id: number; } - src/tools/index.ts:116-130 (registration)The tool definition registration for polarity_dump in the TOOLS array, with name, description, inputSchema (Zod validation for waypoint_id, name, lat, lon, message), and handler that calls client.dump().
{ name: "polarity_dump", description: "Write a short message tied to a location waypoint into the user's graph. PolarityGPS-style. Use only when the user is explicitly recording a place-anchored thought.", inputSchema: z .object({ waypoint_id: z.string().min(1).max(128), name: z.string().min(1).max(128), lat: z.number().optional(), lon: z.number().optional(), message: z.string().min(1).max(500), }) .strict(), handler: async (input, client) => client.dump(input as Parameters<CosmosClient["dump"]>[0]), },