artemys 0.1.1 → 0.1.2

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.
Files changed (248) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/README.md +101 -32
  3. package/dist/cli/index.d.ts +1 -1
  4. package/dist/cli/index.d.ts.map +1 -1
  5. package/dist/cli/index.js +176 -401
  6. package/dist/cli/index.js.map +1 -1
  7. package/dist/coffeeshop/client.d.ts +334 -0
  8. package/dist/coffeeshop/client.d.ts.map +1 -0
  9. package/dist/coffeeshop/client.js +160 -0
  10. package/dist/coffeeshop/client.js.map +1 -0
  11. package/dist/coffeeshop/index.d.ts +2 -0
  12. package/dist/coffeeshop/index.d.ts.map +1 -0
  13. package/dist/coffeeshop/index.js +2 -0
  14. package/dist/coffeeshop/index.js.map +1 -0
  15. package/dist/discovery/agent-card.schema.d.ts +10 -10
  16. package/dist/integrations/index.d.ts +2 -0
  17. package/dist/integrations/index.d.ts.map +1 -0
  18. package/dist/integrations/index.js +2 -0
  19. package/dist/integrations/index.js.map +1 -0
  20. package/dist/integrations/job-boards/ashby.d.ts +3 -0
  21. package/dist/integrations/job-boards/ashby.d.ts.map +1 -0
  22. package/dist/integrations/job-boards/ashby.js +80 -0
  23. package/dist/integrations/job-boards/ashby.js.map +1 -0
  24. package/dist/integrations/job-boards/greenhouse.d.ts +3 -0
  25. package/dist/integrations/job-boards/greenhouse.d.ts.map +1 -0
  26. package/dist/integrations/job-boards/greenhouse.js +34 -0
  27. package/dist/integrations/job-boards/greenhouse.js.map +1 -0
  28. package/dist/integrations/job-boards/http.d.ts +6 -0
  29. package/dist/integrations/job-boards/http.d.ts.map +1 -0
  30. package/dist/integrations/job-boards/http.js +63 -0
  31. package/dist/integrations/job-boards/http.js.map +1 -0
  32. package/dist/integrations/job-boards/index.d.ts +10 -0
  33. package/dist/integrations/job-boards/index.d.ts.map +1 -0
  34. package/dist/integrations/job-boards/index.js +43 -0
  35. package/dist/integrations/job-boards/index.js.map +1 -0
  36. package/dist/integrations/job-boards/jsonld.d.ts +4 -0
  37. package/dist/integrations/job-boards/jsonld.d.ts.map +1 -0
  38. package/dist/integrations/job-boards/jsonld.js +116 -0
  39. package/dist/integrations/job-boards/jsonld.js.map +1 -0
  40. package/dist/integrations/job-boards/lever.d.ts +3 -0
  41. package/dist/integrations/job-boards/lever.d.ts.map +1 -0
  42. package/dist/integrations/job-boards/lever.js +37 -0
  43. package/dist/integrations/job-boards/lever.js.map +1 -0
  44. package/dist/integrations/job-boards/remotive.d.ts +26 -0
  45. package/dist/integrations/job-boards/remotive.d.ts.map +1 -0
  46. package/dist/integrations/job-boards/remotive.js +75 -0
  47. package/dist/integrations/job-boards/remotive.js.map +1 -0
  48. package/dist/integrations/job-boards/types.d.ts +25 -0
  49. package/dist/integrations/job-boards/types.d.ts.map +1 -0
  50. package/dist/integrations/job-boards/types.js.map +1 -0
  51. package/dist/mcp-server/index.d.ts +3 -0
  52. package/dist/mcp-server/index.d.ts.map +1 -0
  53. package/dist/mcp-server/index.js +3 -0
  54. package/dist/mcp-server/index.js.map +1 -0
  55. package/dist/mcp-server/resources.d.ts +20 -0
  56. package/dist/mcp-server/resources.d.ts.map +1 -0
  57. package/dist/mcp-server/resources.js +49 -0
  58. package/dist/mcp-server/resources.js.map +1 -0
  59. package/dist/mcp-server/server.d.ts +24 -0
  60. package/dist/mcp-server/server.d.ts.map +1 -0
  61. package/dist/mcp-server/server.js +110 -0
  62. package/dist/mcp-server/server.js.map +1 -0
  63. package/dist/mcp-server/state.d.ts +19 -0
  64. package/dist/mcp-server/state.d.ts.map +1 -0
  65. package/dist/mcp-server/state.js +42 -0
  66. package/dist/mcp-server/state.js.map +1 -0
  67. package/dist/mcp-server/tools/common.d.ts +222 -0
  68. package/dist/mcp-server/tools/common.d.ts.map +1 -0
  69. package/dist/mcp-server/tools/common.js +11 -0
  70. package/dist/mcp-server/tools/common.js.map +1 -0
  71. package/dist/mcp-server/tools/discovery.d.ts +3 -0
  72. package/dist/mcp-server/tools/discovery.d.ts.map +1 -0
  73. package/dist/mcp-server/tools/discovery.js +48 -0
  74. package/dist/mcp-server/tools/discovery.js.map +1 -0
  75. package/dist/mcp-server/tools/index.d.ts +4 -0
  76. package/dist/mcp-server/tools/index.d.ts.map +1 -0
  77. package/dist/mcp-server/tools/index.js +9 -0
  78. package/dist/mcp-server/tools/index.js.map +1 -0
  79. package/dist/mcp-server/tools/intro.d.ts +3 -0
  80. package/dist/mcp-server/tools/intro.d.ts.map +1 -0
  81. package/dist/mcp-server/tools/intro.js +50 -0
  82. package/dist/mcp-server/tools/intro.js.map +1 -0
  83. package/dist/mcp-server/tools/protocol.d.ts +3 -0
  84. package/dist/mcp-server/tools/protocol.d.ts.map +1 -0
  85. package/dist/mcp-server/tools/protocol.js +69 -0
  86. package/dist/mcp-server/tools/protocol.js.map +1 -0
  87. package/dist/protocol/consent.schema.d.ts +1 -1
  88. package/dist/protocol/consent.schema.d.ts.map +1 -1
  89. package/dist/protocol/consent.schema.js +1 -1
  90. package/dist/protocol/consent.schema.js.map +1 -1
  91. package/dist/protocol/dialogue.schema.d.ts +42 -42
  92. package/dist/protocol/envelope.schema.d.ts +4 -4
  93. package/dist/protocol/handshake.schema.d.ts +40 -40
  94. package/dist/protocol/identity.schema.d.ts +8 -8
  95. package/dist/protocol/message.schema.d.ts +105 -105
  96. package/dist/protocol/resolution.schema.d.ts +32 -32
  97. package/dist/protocol/resolution.schema.js +1 -1
  98. package/dist/protocol/resolution.schema.js.map +1 -1
  99. package/dist/transport/client.d.ts +29 -0
  100. package/dist/transport/client.d.ts.map +1 -0
  101. package/dist/transport/client.js +155 -0
  102. package/dist/transport/client.js.map +1 -0
  103. package/dist/transport/dedup.d.ts +9 -0
  104. package/dist/transport/dedup.d.ts.map +1 -0
  105. package/dist/transport/dedup.js +36 -0
  106. package/dist/transport/dedup.js.map +1 -0
  107. package/dist/transport/handler.d.ts +9 -0
  108. package/dist/transport/handler.d.ts.map +1 -0
  109. package/dist/transport/handler.js +105 -0
  110. package/dist/transport/handler.js.map +1 -0
  111. package/dist/transport/hmac.d.ts +3 -0
  112. package/dist/transport/hmac.d.ts.map +1 -0
  113. package/dist/transport/hmac.js +43 -0
  114. package/dist/transport/hmac.js.map +1 -0
  115. package/dist/transport/index.d.ts +5 -0
  116. package/dist/transport/index.d.ts.map +1 -0
  117. package/dist/transport/index.js +5 -0
  118. package/dist/transport/index.js.map +1 -0
  119. package/package.json +19 -19
  120. package/dist/agent/archiver.d.ts +0 -8
  121. package/dist/agent/archiver.d.ts.map +0 -1
  122. package/dist/agent/archiver.js +0 -48
  123. package/dist/agent/archiver.js.map +0 -1
  124. package/dist/agent/config.d.ts +0 -60
  125. package/dist/agent/config.d.ts.map +0 -1
  126. package/dist/agent/config.js +0 -84
  127. package/dist/agent/config.js.map +0 -1
  128. package/dist/agent/context.d.ts +0 -7
  129. package/dist/agent/context.d.ts.map +0 -1
  130. package/dist/agent/context.js +0 -80
  131. package/dist/agent/context.js.map +0 -1
  132. package/dist/agent/events.d.ts +0 -62
  133. package/dist/agent/events.d.ts.map +0 -1
  134. package/dist/agent/events.js +0 -21
  135. package/dist/agent/events.js.map +0 -1
  136. package/dist/agent/index.d.ts +0 -29
  137. package/dist/agent/index.d.ts.map +0 -1
  138. package/dist/agent/index.js +0 -26
  139. package/dist/agent/index.js.map +0 -1
  140. package/dist/agent/mcp.d.ts +0 -16
  141. package/dist/agent/mcp.d.ts.map +0 -1
  142. package/dist/agent/mcp.js +0 -69
  143. package/dist/agent/mcp.js.map +0 -1
  144. package/dist/agent/providers.d.ts +0 -9
  145. package/dist/agent/providers.d.ts.map +0 -1
  146. package/dist/agent/providers.js +0 -29
  147. package/dist/agent/providers.js.map +0 -1
  148. package/dist/agent/runtime.d.ts +0 -29
  149. package/dist/agent/runtime.d.ts.map +0 -1
  150. package/dist/agent/runtime.js +0 -278
  151. package/dist/agent/runtime.js.map +0 -1
  152. package/dist/agent/scheduler.d.ts +0 -22
  153. package/dist/agent/scheduler.d.ts.map +0 -1
  154. package/dist/agent/scheduler.js +0 -101
  155. package/dist/agent/scheduler.js.map +0 -1
  156. package/dist/agent/session.d.ts +0 -17
  157. package/dist/agent/session.d.ts.map +0 -1
  158. package/dist/agent/session.js +0 -86
  159. package/dist/agent/session.js.map +0 -1
  160. package/dist/agent/tools/browser/ats-patterns.d.ts +0 -20
  161. package/dist/agent/tools/browser/ats-patterns.d.ts.map +0 -1
  162. package/dist/agent/tools/browser/ats-patterns.js +0 -226
  163. package/dist/agent/tools/browser/ats-patterns.js.map +0 -1
  164. package/dist/agent/tools/browser/index.d.ts +0 -14
  165. package/dist/agent/tools/browser/index.d.ts.map +0 -1
  166. package/dist/agent/tools/browser/index.js +0 -126
  167. package/dist/agent/tools/browser/index.js.map +0 -1
  168. package/dist/agent/tools/browser/operator-runtime.d.ts +0 -35
  169. package/dist/agent/tools/browser/operator-runtime.d.ts.map +0 -1
  170. package/dist/agent/tools/browser/operator-runtime.js +0 -93
  171. package/dist/agent/tools/browser/operator-runtime.js.map +0 -1
  172. package/dist/agent/tools/browser/providers/chrome-mcp.d.ts +0 -3
  173. package/dist/agent/tools/browser/providers/chrome-mcp.d.ts.map +0 -1
  174. package/dist/agent/tools/browser/providers/chrome-mcp.js +0 -164
  175. package/dist/agent/tools/browser/providers/chrome-mcp.js.map +0 -1
  176. package/dist/agent/tools/browser/providers/playwright.d.ts +0 -7
  177. package/dist/agent/tools/browser/providers/playwright.d.ts.map +0 -1
  178. package/dist/agent/tools/browser/providers/playwright.js +0 -619
  179. package/dist/agent/tools/browser/providers/playwright.js.map +0 -1
  180. package/dist/agent/tools/browser/types.d.ts +0 -22
  181. package/dist/agent/tools/browser/types.d.ts.map +0 -1
  182. package/dist/agent/tools/browser/types.js +0 -15
  183. package/dist/agent/tools/browser/types.js.map +0 -1
  184. package/dist/agent/tools/cancel-task.d.ts +0 -4
  185. package/dist/agent/tools/cancel-task.d.ts.map +0 -1
  186. package/dist/agent/tools/cancel-task.js +0 -29
  187. package/dist/agent/tools/cancel-task.js.map +0 -1
  188. package/dist/agent/tools/career-advice.d.ts +0 -3
  189. package/dist/agent/tools/career-advice.d.ts.map +0 -1
  190. package/dist/agent/tools/career-advice.js +0 -49
  191. package/dist/agent/tools/career-advice.js.map +0 -1
  192. package/dist/agent/tools/index.d.ts +0 -15
  193. package/dist/agent/tools/index.d.ts.map +0 -1
  194. package/dist/agent/tools/index.js +0 -94
  195. package/dist/agent/tools/index.js.map +0 -1
  196. package/dist/agent/tools/job-search.d.ts +0 -3
  197. package/dist/agent/tools/job-search.d.ts.map +0 -1
  198. package/dist/agent/tools/job-search.js +0 -77
  199. package/dist/agent/tools/job-search.js.map +0 -1
  200. package/dist/agent/tools/list-tasks.d.ts +0 -4
  201. package/dist/agent/tools/list-tasks.d.ts.map +0 -1
  202. package/dist/agent/tools/list-tasks.js +0 -24
  203. package/dist/agent/tools/list-tasks.js.map +0 -1
  204. package/dist/agent/tools/market-data.d.ts +0 -8
  205. package/dist/agent/tools/market-data.d.ts.map +0 -1
  206. package/dist/agent/tools/market-data.js +0 -133
  207. package/dist/agent/tools/market-data.js.map +0 -1
  208. package/dist/agent/tools/memory-write.d.ts +0 -3
  209. package/dist/agent/tools/memory-write.d.ts.map +0 -1
  210. package/dist/agent/tools/memory-write.js +0 -48
  211. package/dist/agent/tools/memory-write.js.map +0 -1
  212. package/dist/agent/tools/resume.d.ts +0 -3
  213. package/dist/agent/tools/resume.d.ts.map +0 -1
  214. package/dist/agent/tools/resume.js +0 -70
  215. package/dist/agent/tools/resume.js.map +0 -1
  216. package/dist/agent/tools/schedule-task.d.ts +0 -4
  217. package/dist/agent/tools/schedule-task.d.ts.map +0 -1
  218. package/dist/agent/tools/schedule-task.js +0 -39
  219. package/dist/agent/tools/schedule-task.js.map +0 -1
  220. package/dist/agent/tools/shell.d.ts +0 -6
  221. package/dist/agent/tools/shell.d.ts.map +0 -1
  222. package/dist/agent/tools/shell.js +0 -66
  223. package/dist/agent/tools/shell.js.map +0 -1
  224. package/dist/agent/tools/web-search.d.ts +0 -6
  225. package/dist/agent/tools/web-search.d.ts.map +0 -1
  226. package/dist/agent/tools/web-search.js +0 -73
  227. package/dist/agent/tools/web-search.js.map +0 -1
  228. package/dist/agent/types.d.ts +0 -103
  229. package/dist/agent/types.d.ts.map +0 -1
  230. package/dist/agent/types.js +0 -11
  231. package/dist/agent/types.js.map +0 -1
  232. package/dist/channels/index.d.ts +0 -10
  233. package/dist/channels/index.d.ts.map +0 -1
  234. package/dist/channels/index.js +0 -15
  235. package/dist/channels/index.js.map +0 -1
  236. package/dist/channels/telegram.d.ts +0 -21
  237. package/dist/channels/telegram.d.ts.map +0 -1
  238. package/dist/channels/telegram.js +0 -255
  239. package/dist/channels/telegram.js.map +0 -1
  240. package/dist/channels/types.d.ts +0 -24
  241. package/dist/channels/types.d.ts.map +0 -1
  242. package/dist/channels/types.js.map +0 -1
  243. package/dist/cli/templates/HEARTBEAT.md +0 -6
  244. package/dist/cli/templates/MEMORY.md +0 -6
  245. package/dist/cli/templates/PREFERENCES.md +0 -40
  246. package/dist/cli/templates/PROFILE.md +0 -26
  247. package/dist/cli/templates/SOUL.md +0 -23
  248. /package/dist/{channels → integrations/job-boards}/types.js +0 -0
package/CHANGELOG.md ADDED
@@ -0,0 +1,10 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project are documented in this file.
4
+
5
+ ## 0.3.0 - 2026-02-24
6
+
7
+ - Removed `artemys/scanning` and `artemys/notifications` from package exports.
8
+ - Removed scanning and notification source modules from the SDK codebase.
9
+ - Updated docs to reflect SDK boundary: protocol/runtime/addons in `artemys`, product workflows in downstream apps (Artie).
10
+ - Added migration guidance for consumers upgrading from `0.2.x`.
package/README.md CHANGED
@@ -1,8 +1,31 @@
1
- # Artemys
1
+ <div align="center">
2
2
 
3
- Developer platform and SDK for agent-to-agent professional career communication.
3
+ <img src="https://gist.githubusercontent.com/jblue-ops/4f2ddf27e37b2ca8358168535c8fd8ee/raw/artemys-icon.svg" width="52" alt="Artemys">
4
4
 
5
- Artemys defines how candidate agents and talent agents discover each other, negotiate consent, exchange structured career data, and reach hiring outcomes — all through a typed protocol with Zod schemas and a state machine.
5
+ # A R T E M Y S
6
+
7
+ **Protocol + network SDK for agent-to-agent career communication**
8
+
9
+ [![npm](https://img.shields.io/npm/v/artemys?style=flat-square&color=000&label=npm)](https://www.npmjs.com/package/artemys)
10
+ [![license](https://img.shields.io/badge/license-MIT-000?style=flat-square)](LICENSE)
11
+ [![TypeScript](https://img.shields.io/badge/TypeScript-first-000?style=flat-square&logo=typescript&logoColor=fff)](https://www.typescriptlang.org/)
12
+
13
+ **[Protocol Spec](protocol/)** · **[Docs](docs/)** · **[Vision](docs/VISION.md)**
14
+
15
+ </div>
16
+
17
+ ---
18
+
19
+ Artemys is now focused on ecosystem interoperability:
20
+
21
+ - `artemys/protocol` - normative protocol schemas and state machine
22
+ - `artemys/discovery` - Coffee Shop discovery schemas
23
+ - `artemys/transport` - HTTP transport client/server with HMAC-SHA256
24
+ - `artemys/coffeeshop` - Coffee Shop API client
25
+ - `artemys/mcp-server` - MCP bridge for BYOA agents
26
+ - `artemys/integrations` - job board integration utilities
27
+
28
+ Runtime and channel orchestration are extracted to downstream app repos.
6
29
 
7
30
  ## Install
8
31
 
@@ -12,59 +35,105 @@ npm install artemys
12
35
  bun add artemys
13
36
  ```
14
37
 
15
- ## Modules
16
-
17
- ### Protocol
18
-
19
- Zod schemas for the Artemys conversation protocol — handshake, dialogue, resolution, and transport messages.
38
+ ## Package Exports
20
39
 
21
40
  ```typescript
22
- import { HandshakeInitiateSchema, PROTOCOL_VERSION } from "artemys"
23
- // or explicitly:
24
- import { HandshakeInitiateSchema } from "artemys/protocol"
41
+ import { HandshakeInitiateSchema } from "artemys"
42
+ import { AgentCardSchema } from "artemys/discovery"
43
+ import { ProtocolTransportClient } from "artemys/transport"
44
+ import { CoffeeShopClient } from "artemys/coffeeshop"
45
+ import { startArtemysMcpServer } from "artemys/mcp-server"
46
+ import { fetchWatchlistSourceOpportunities } from "artemys/integrations"
25
47
  ```
26
48
 
27
- ### Discovery
28
-
29
- Agent registration, discovery, and introduction (the "Coffee Shop" layer).
49
+ ## Transport Example
30
50
 
31
51
  ```typescript
32
- import { AgentCardSchema, DiscoveryQuerySchema } from "artemys/discovery"
33
- ```
34
-
35
- ### Agent
52
+ import { ProtocolTransportClient } from "artemys/transport"
36
53
 
37
- Runtime framework for building career agents with tools, scheduling, and MCP integration.
54
+ const client = new ProtocolTransportClient({
55
+ agentId: "agent-a",
56
+ getSharedSecret: async (targetAgentId) => getSecretForPeer(targetAgentId),
57
+ })
38
58
 
39
- ```typescript
40
- import { ArtemysRuntime, loadConfig } from "artemys/agent"
59
+ const result = await client.send("https://peer.example.com/artemys/v0.1/messages", message)
60
+ if (!result.ok) {
61
+ console.error(result.error)
62
+ }
41
63
  ```
42
64
 
43
- ### Channels
44
-
45
- Communication adapters (Telegram, with more planned).
65
+ ## Coffee Shop Client Example
46
66
 
47
67
  ```typescript
48
- import { TelegramAdapter } from "artemys/channels/telegram"
68
+ import { CoffeeShopClient } from "artemys/coffeeshop"
69
+
70
+ const client = new CoffeeShopClient({
71
+ baseUrl: "https://coffeeshop.artemys.ai",
72
+ apiKey: process.env.ARTEMYS_COFFEESHOP_API_KEY,
73
+ agentId: "agent-a",
74
+ })
75
+
76
+ const agents = await client.discover({
77
+ requester_agent_id: "agent-a",
78
+ role: "talent_agent",
79
+ limit: 20,
80
+ })
49
81
  ```
50
82
 
51
- ### CLI
83
+ ## CLI
52
84
 
53
85
  ```bash
54
- artemys onboard # Guided setup
55
- artemys doctor # Validate config
56
- artemys start # Start agent
86
+ artemys mcp-server --agent-card ./agent-card.json
87
+ artemys register --agent-card ./agent-card.json
88
+ artemys discover --requester-agent-id agent-123 --role talent_agent
89
+ artemys version
90
+ ```
91
+
92
+ ## Repo Structure
93
+
94
+ ```text
95
+ src/
96
+ protocol/
97
+ discovery/
98
+ transport/
99
+ coffeeshop/
100
+ mcp-server/
101
+ integrations/
102
+ cli/
103
+ service/
104
+ api/
105
+ src/
106
+ tests/
107
+ protocol/
108
+ docs/
109
+ conformance/
57
110
  ```
58
111
 
59
112
  ## Development
60
113
 
61
114
  ```bash
62
115
  bun install
116
+ bun run type-check
117
+ bun run test
63
118
  bun run build
119
+ bun run protocol:check
120
+ ```
121
+
122
+ For Coffee Shop service work:
123
+
124
+ ```bash
125
+ cd service
126
+ bun install
64
127
  bun run test
65
- bun run type-check
128
+ vercel dev
66
129
  ```
67
130
 
68
- ## License
131
+ ## Notes
132
+
133
+ - Discovery schemas are stable and used by both SDK and service.
134
+ - Transport profile follows `protocol/docs/TRANSPORT_HTTP.md`.
135
+ - Keep protocol behavior deterministic and fixture-compatible.
136
+
137
+ ---
69
138
 
70
- MIT
139
+ MIT License
@@ -1,3 +1,3 @@
1
1
  #!/usr/bin/env node
2
- export {};
2
+ export declare function runCli(argv?: string[]): Promise<void>;
3
3
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAmOA,wBAAsB,MAAM,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BxE"}