@cognitiondesk/widget

@cognitiondesk/widget

Embeddable CognitionDesk chat widget for vanilla JS and React.

The package also exports a lightweight assistant client for managing assistants and invoking them against the CognitionDesk backend.

Modular packages

If your app only needs command-based assistant management (no widget UI), install the dedicated SDK package:

npm install @cognitiondesk/client

Use @cognitiondesk/widget only when you need the embeddable chat widget UI.

Install

npm install @cognitiondesk/widget

Vanilla usage

<script src="https://cdn.example.com/widget.umd.cjs"></script>
<script>
	CognitionDesk.init({
		apiKey: "YOUR_API_KEY",
		widgetId: "widget_xxx",
	});
</script>

React usage

import { CognitionDeskWidget } from '@cognitiondesk/widget/react';

export function Chat() {
	return (
		<CognitionDeskWidget
			apiKey="YOUR_API_KEY"
			widgetId="widget_xxx"
			position="bottom-right"
			offsetX={12}
			offsetY={8}
			botAvatar="https://cdn.example.com/avatar.png"
			avatarSize={44}
			avatarCircle={false}
			avatarShowBackground={false}
		/>
	);
}

Assistant client

For non-UI integrations, prefer @cognitiondesk/client.

import { createCognitionDeskClient } from '@cognitiondesk/client';

@cognitiondesk/widget still re-exports the same API for backward compatibility:

import { createCognitionDeskClient } from '@cognitiondesk/widget';

Architecture

This is a Tier 2 package in the three-tier model:

Tier 1 — @mounaji_npm/*          (base: tokens, ui, web-widget, ...)
Tier 2 — @cognitiondesk/*        (this package + client, agent-runtime, ...)
Tier 3 — apps (ai-forum-app, mounaji-platform, ...)

The widget UI engine lives in @mounaji_npm/web-widget (Tier 1). This package wraps it with CognitionDesk branding and re-exports @cognitiondesk/client for backward compatibility.

License

MIT