@agentapps/app.kelify 0.0.0-stage → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,45 @@
1
- # Temporary Holding Version
1
+ # Kelify AI Property Search
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Lets an agent search real estate listings by talking to Kelify's conversational search API
4
+ (`https://api.kelify.com`). The agent opens a conversation, sends messages in natural language
5
+ and gets back an answer with matching properties: price, address, rooms, size, photos and a
6
+ link. A conversation keeps its context, so follow-up questions refine the same search.
7
+
8
+ ## Tools
9
+
10
+ | Tool | What it does | Writes? |
11
+ |---|---|---|
12
+ | `create-conversation` | Opens a new search conversation and returns its id. | yes, sensitive |
13
+ | `send-message` | Sends a message (up to 2000 characters) to a conversation and returns the answer with the properties found. | yes, sensitive |
14
+ | `get-conversation` | Returns a conversation's messages, results and usage. | no |
15
+
16
+ Limits:
17
+
18
+ - Answers are not streamed: `send-message` returns when the whole answer is ready, within a
19
+ 30 second deadline.
20
+ - Only reads are retried on a transient error. Creating a conversation or sending a message is
21
+ never retried, so a failed call may need to be repeated by hand.
22
+
23
+ ## Setup
24
+
25
+ ```bash
26
+ agentapps install app.kelify kelify
27
+ agentapps config app.kelify KELIFY_API_KEY:<your key>
28
+ agentapps kelify tools
29
+ agentapps kelify tool create-conversation
30
+ ```
31
+
32
+ `KELIFY_API_KEY` is a system secret: one key for every installation of the app. Ask Kelify for
33
+ one. The app reads it from the Station on each call and never stores it.
34
+
35
+ ## Terms of use
36
+
37
+ Kelify's own terms apply to everything the app does on your behalf:
38
+ <https://kelify.com/legal/terms>. TODO: note here any limit on usage or commercial use that
39
+ matters to someone installing the app.
40
+
41
+ ## Logos
42
+
43
+ TODO: record the official source of `assets/logo.svg` and `assets/logo-mono.svg` (Kelify's press
44
+ kit, brand guidelines or its own site). They have been in the repository since before this
45
+ README existed and their origin was not written down.
package/agentapp.json ADDED
@@ -0,0 +1,18 @@
1
+ {
2
+ "id": "app.kelify",
3
+ "name": "Kelify AI Property Search",
4
+ "version": "2.0.1",
5
+ "description": "AI-powered conversational property search API for real estate listings",
6
+ "tagline": "Search real estate listings through AI-powered conversations",
7
+ "author": { "name": "Kelify", "email": "contact@kelify.com" },
8
+ "license": "MIT",
9
+ "logo": "assets/logo.svg",
10
+ "logoMono": "assets/logo-mono.svg",
11
+ "terms": "https://agentapps.tech/terms",
12
+ "category": "ai",
13
+ "keywords": ["real estate", "property search", "ai", "conversational", "kelify"],
14
+ "entrypoint": { "type": "module", "path": "src/app.ts", "export": "factory" },
15
+ "runtime": { "transport": "stdio", "command": "tsx", "args": ["src/app.ts"] },
16
+ "capabilities": { "tools": true, "health": true },
17
+ "auth": { "type": "api-key", "systemSecrets": ["KELIFY_API_KEY"] }
18
+ }