@artooi/ag-ui-web-component 0.1.0

package/src/styles.ts

@@ -0,0 +1,296 @@
+// Shadow-DOM-scoped styles for the chat shell. Kept as a string constant so
+// the Custom Element can inject it into its shadow root without a build-time
+// CSS pipeline. Scoped by the shadow boundary, so class names stay terse.
+
+export const STYLES = `
+:host {
+  /* Colors */
+  --ag-ui-bg: #ffffff;
+  --ag-ui-fg: #1a1a2e;
+  --ag-ui-accent: #4f46e5;
+  --ag-ui-user-bg: #4f46e5;
+  --ag-ui-user-fg: #ffffff;
+  --ag-ui-assistant-bg: #f1f1f6;
+  --ag-ui-input-bg: var(--ag-ui-bg);
+  --ag-ui-tool-bg: var(--ag-ui-assistant-bg);
+  --ag-ui-tool-fg: var(--ag-ui-accent);
+  --ag-ui-header-bg: var(--ag-ui-accent);
+  --ag-ui-header-fg: #ffffff;
+  --ag-ui-border: #e2e2ec;
+  --ag-ui-radius: 12px;
+
+  /* Status accents for tool-call cards. */
+  --ag-ui-success: #15803d;
+  --ag-ui-danger: #b91c1c;
+  --ag-ui-muted: #6b7280;
+
+  /* Surface — set --ag-ui-shadow: none for a flush, embedded panel. */
+  --ag-ui-shadow: 0 12px 32px rgba(20, 20, 50, 0.18);
+  --ag-ui-font: inherit;
+  --ag-ui-font-size: 14px;
+
+  /* Layout — override from outside to dock the widget anywhere.
+     Set --ag-ui-position: static (and place this element in your own
+     grid/flex layout) to embed it in the page flow instead of floating. */
+  --ag-ui-position: fixed;
+  --ag-ui-z-index: 2147483000;
+  --ag-ui-width: 380px;
+  --ag-ui-height: 560px;
+  --ag-ui-inset: auto 24px 24px auto;
+  --ag-ui-max-width: calc(100vw - 48px);
+  --ag-ui-max-height: calc(100vh - 48px);
+
+  position: var(--ag-ui-position);
+  inset: var(--ag-ui-inset);
+  z-index: var(--ag-ui-z-index);
+  width: var(--ag-ui-width);
+  max-width: var(--ag-ui-max-width);
+  height: var(--ag-ui-height);
+  max-height: var(--ag-ui-max-height);
+  display: flex;
+  font-family: var(--ag-ui-font);
+  font-size: var(--ag-ui-font-size);
+  color: var(--ag-ui-fg);
+}
+
+.chat {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  flex: 1;
+  min-height: 0;
+  background: var(--ag-ui-bg);
+  border: 1px solid var(--ag-ui-border);
+  border-radius: var(--ag-ui-radius);
+  box-shadow: var(--ag-ui-shadow);
+  overflow: hidden;
+}
+
+.header {
+  padding: 12px 16px;
+  font-weight: 600;
+  border-bottom: 1px solid var(--ag-ui-border);
+  background: var(--ag-ui-header-bg);
+  color: var(--ag-ui-header-fg);
+}
+
+.messages {
+  flex: 1;
+  overflow-y: auto;
+  padding: 16px;
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+
+.message {
+  max-width: 80%;
+  padding: 8px 12px;
+  border-radius: 14px;
+  line-height: 1.4;
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+
+.message--user {
+  align-self: flex-end;
+  background: var(--ag-ui-user-bg);
+  color: var(--ag-ui-user-fg);
+  border-bottom-right-radius: 4px;
+}
+
+.message--assistant {
+  align-self: flex-start;
+  background: var(--ag-ui-assistant-bg);
+  border-bottom-left-radius: 4px;
+}
+
+.tool-call {
+  align-self: flex-start;
+  max-width: 80%;
+  box-sizing: border-box;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  font-size: 12px;
+  font-family: ui-monospace, "SF Mono", Menlo, monospace;
+  padding: 8px 10px;
+  border-radius: 8px;
+  background: var(--ag-ui-tool-bg);
+  border: 1px solid var(--ag-ui-border);
+  color: var(--ag-ui-tool-fg);
+}
+
+.tool-call-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+}
+
+.tool-call-name {
+  font-weight: 600;
+  word-break: break-word;
+}
+
+.tool-call-status {
+  flex: none;
+  padding: 1px 8px;
+  border-radius: 999px;
+  font-size: 11px;
+  font-weight: 600;
+  background: rgba(127, 127, 127, 0.16);
+  color: var(--ag-ui-muted);
+}
+
+.tool-call[data-status="done"] .tool-call-status {
+  color: var(--ag-ui-success);
+}
+
+.tool-call[data-status="error"] .tool-call-status {
+  color: var(--ag-ui-danger);
+}
+
+.tool-call[data-status="declined"] .tool-call-status {
+  color: var(--ag-ui-muted);
+}
+
+.tool-call-args,
+.tool-call-result {
+  margin: 0;
+  padding: 6px 8px;
+  max-height: 160px;
+  overflow: auto;
+  background: var(--ag-ui-bg);
+  border: 1px solid var(--ag-ui-border);
+  border-radius: 6px;
+  white-space: pre-wrap;
+  word-break: break-word;
+  color: var(--ag-ui-fg);
+}
+
+.tool-call-toggle {
+  align-self: flex-start;
+  border: none;
+  padding: 0;
+  background: none;
+  font: inherit;
+  font-weight: 600;
+  color: var(--ag-ui-accent);
+  cursor: pointer;
+}
+
+.tool-call-toggle::before {
+  content: "▸ ";
+}
+
+.tool-call-toggle[aria-expanded="true"]::before {
+  content: "▾ ";
+}
+
+.input-row {
+  display: flex;
+  gap: 8px;
+  padding: 12px;
+  border-top: 1px solid var(--ag-ui-border);
+}
+
+.input {
+  flex: 1;
+  resize: none;
+  background: var(--ag-ui-input-bg);
+  border: 1px solid var(--ag-ui-border);
+  border-radius: 8px;
+  padding: 8px 10px;
+  font: inherit;
+  color: inherit;
+  outline: none;
+}
+
+.input:focus {
+  border-color: var(--ag-ui-accent);
+}
+
+.send {
+  border: none;
+  border-radius: 8px;
+  padding: 0 16px;
+  background: var(--ag-ui-accent);
+  color: #ffffff;
+  font: inherit;
+  font-weight: 600;
+  cursor: pointer;
+}
+
+.send:disabled {
+  opacity: 0.5;
+  cursor: default;
+}
+
+.modal-overlay {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 16px;
+  background: rgba(20, 20, 50, 0.4);
+  backdrop-filter: blur(2px);
+}
+
+.modal {
+  width: 100%;
+  max-width: 320px;
+  background: var(--ag-ui-bg);
+  border-radius: 12px;
+  box-shadow: 0 16px 40px rgba(20, 20, 50, 0.3);
+  overflow: hidden;
+}
+
+.modal-title {
+  padding: 12px 16px;
+  font-weight: 600;
+  border-bottom: 1px solid var(--ag-ui-border);
+}
+
+.modal-body {
+  padding: 12px 16px 4px;
+}
+
+.modal-args {
+  margin: 0 16px 12px;
+  padding: 8px 10px;
+  max-height: 140px;
+  overflow: auto;
+  font-size: 12px;
+  font-family: ui-monospace, "SF Mono", Menlo, monospace;
+  background: var(--ag-ui-assistant-bg);
+  border-radius: 8px;
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+
+.modal-actions {
+  display: flex;
+  gap: 8px;
+  padding: 0 16px 16px;
+  justify-content: flex-end;
+}
+
+.modal-btn {
+  border: 1px solid var(--ag-ui-border);
+  border-radius: 8px;
+  padding: 8px 14px;
+  font: inherit;
+  font-weight: 600;
+  cursor: pointer;
+  background: var(--ag-ui-bg);
+  color: var(--ag-ui-fg);
+}
+
+.modal-btn--confirm {
+  border-color: var(--ag-ui-accent);
+  background: var(--ag-ui-accent);
+  color: #ffffff;
+}
+`;

package/src/tool_call_card.ts

@@ -0,0 +1,95 @@
+import { TOOL_CALL_STATUS } from "./constants.js";
+
+/** Any state a tool-call card can be in. */
+export type ToolCallStatus = (typeof TOOL_CALL_STATUS)[keyof typeof TOOL_CALL_STATUS];
+
+/** The terminal states a card settles into (everything but `pending`). */
+export type SettledStatus = Exclude<ToolCallStatus, typeof TOOL_CALL_STATUS.PENDING>;
+
+/** Short pill text shown for each status. */
+const STATUS_LABEL: Record<ToolCallStatus, string> = {
+  [TOOL_CALL_STATUS.PENDING]: "running…",
+  [TOOL_CALL_STATUS.DONE]: "✓ done",
+  [TOOL_CALL_STATUS.ERROR]: "⚠ error",
+  [TOOL_CALL_STATUS.DECLINED]: "⊘ declined",
+};
+
+/** Toggle-button label for each settled outcome's collapsible body. */
+const RESULT_LABEL: Record<SettledStatus, string> = {
+  [TOOL_CALL_STATUS.DONE]: "Result",
+  [TOOL_CALL_STATUS.ERROR]: "Error",
+  [TOOL_CALL_STATUS.DECLINED]: "Declined",
+};
+
+/**
+ * A live tool-call card for the chat transcript.
+ *
+ * Construction renders the tool name, its pretty-printed arguments, and a
+ * `running…` status pill. {@link settle} later flips the pill to the outcome
+ * and appends a click-to-expand body holding the result (or error / decline
+ * message), collapsed by default.
+ *
+ * Pure DOM (no framework); the host appends {@link element} into its shadow
+ * root and themes it via the `--ag-ui-*` custom properties.
+ */
+export class ToolCallCard {
+  /** The card's root element; append this into the message list. */
+  readonly element: HTMLDivElement;
+
+  readonly #status: HTMLSpanElement;
+
+  constructor(name: string, args: Record<string, unknown>) {
+    this.element = document.createElement("div");
+    this.element.className = "tool-call";
+    this.element.setAttribute("data-tool-name", name);
+    this.element.setAttribute("data-status", TOOL_CALL_STATUS.PENDING);
+
+    const head = document.createElement("div");
+    head.className = "tool-call-head";
+
+    const label = document.createElement("span");
+    label.className = "tool-call-name";
+    label.textContent = `🔧 ${name}`;
+
+    this.#status = document.createElement("span");
+    this.#status.className = "tool-call-status";
+    this.#status.textContent = STATUS_LABEL[TOOL_CALL_STATUS.PENDING];
+
+    head.append(label, this.#status);
+
+    const argsEl = document.createElement("pre");
+    argsEl.className = "tool-call-args";
+    argsEl.textContent = JSON.stringify(args, null, 2);
+
+    this.element.append(head, argsEl);
+  }
+
+  /**
+   * Flip the status pill to ``status`` and append a collapsed body holding
+   * ``text`` (the JSON result, an error message, a decline notice, or a
+   * server-executed note) behind a click-to-expand toggle.
+   */
+  settle(status: SettledStatus, text: string): void {
+    this.element.setAttribute("data-status", status);
+    this.#status.textContent = STATUS_LABEL[status];
+
+    const toggle = document.createElement("button");
+    toggle.type = "button";
+    toggle.className = "tool-call-toggle";
+    toggle.setAttribute("aria-expanded", "false");
+    toggle.textContent = RESULT_LABEL[status];
+
+    const output = document.createElement("pre");
+    output.className = "tool-call-result";
+    output.textContent = text;
+    output.hidden = true;
+
+    toggle.addEventListener("click", () => {
+      const expand = output.hidden;
+      output.hidden = !expand;
+      toggle.setAttribute("aria-expanded", String(expand));
+    });
+
+    this.element.append(toggle, output);
+  }
+}

package/src/version.ts

@@ -0,0 +1 @@
+export const VERSION: string = "0.1.0";