@preply/ds-ai-core 11.1.0

package/AGENTS.md

@@ -0,0 +1,7 @@
+# Agents: ai-core
+
+This package contains the tool definitions (names, descriptions, arguments, options, callbacks) that power both `@preply/ds-ai-cli` and `@preply/ds-ai-mcp`.
+
+## Keep in sync
+
+When adding, removing, or changing tools (arguments, options, descriptions) in `src/tools/`, update the consumer-facing agent skill at `skills/design-system/SKILL.md` to reflect the new tool capabilities and CLI syntax.

package/README.md

@@ -0,0 +1,34 @@
+# `@preply/ds-ai-core`
+
+> Shared library of AI-facing tools for the Preply Design System.
+
+Provides tool definitions consumed by [`@preply/ds-ai-mcp`](../ai-mcp/README.md) (MCP server) and [`@preply/ds-ai-cli`](../ai-cli/README.md) (CLI).
+
+## Tools
+
+| Tool                 | Description                                             |
+| -------------------- | ------------------------------------------------------- |
+| `searchIcon`         | Fuzzy-search icons from `@preply/ds-media-icons`        |
+| `searchTokenByName`  | Search design tokens by name (scss / less / typescript) |
+| `searchTokenByValue` | Reverse-lookup tokens by their resolved value           |
+| `listComponents`     | List all available DS components with metadata          |
+| `getComponentDocs`   | Get full documentation for a specific component         |
+
+Each tool is defined via `defineTool` with Zod schemas for arguments/options, making them automatically consumable by both CLI (via `zod-commander`) and MCP (via `inputSchema`).
+
+## Architecture
+
+- **Build-time macros** — `unplugin-macros` inlines data (icon lists, token maps, component docs) at build time via `with { type: 'macro' }` imports, so consumers don't need filesystem access at runtime.
+- **Search** — [Lunr](https://lunrjs.com/) powers fuzzy search for icons and tokens, with custom pipeline functions for camelCase/kebab-case splitting.
+- **Event tracking** — PostHog client for anonymous usage analytics (`identify`, `trackToolCall`).
+
+## Development
+
+```bash
+yarn build        # Build the package
+yarn dev          # Build in watch mode
+yarn test         # Run tests
+yarn test:watch   # Run tests in watch mode
+yarn check:types  # Type-check
+yarn lint         # Lint
+```

package/dist/event-tracking.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Identifies the current user.
+ * Should be called once at the start of the program.
+ */
+export declare function identify(): void;
+/**
+ * Tracks a generic event.
+ */
+export declare function trackEvent(eventName: string, properties?: Record<string, unknown>): void;
+/**
+ * Tracks a tool call.
+ * Should be called for each tool call.
+ */
+export declare function trackToolCall(toolName: string, args: Record<string, unknown>, meta?: Record<string, unknown>): void;
+/**
+ * Flushes all pending events and shuts down the PostHog client.
+ * Must be called before process exit in short-lived processes (e.g. CLI)
+ * to ensure events are actually sent over the network.
+ */
+export declare function shutdownEventTracking(): Promise<void>;
+//# sourceMappingURL=event-tracking.d.ts.map

package/dist/event-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-tracking.d.ts","sourceRoot":"","sources":["../src/event-tracking.ts"],"names":[],"mappings":"AAiDA;;;GAGG;AACH,wBAAgB,QAAQ,SAcvB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAejF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CACzB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAOjC;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,kBAM1C"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * as tools from './tools';
+export * from './event-tracking';
+export * from './types';
+export type { Tool } from './utils/define-tool';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,YAAY,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC"}