Skip to content

AI driven algolia search#186

Merged
saif-at-scalekit merged 14 commits intomainfrom
preview/ai-search
Jan 7, 2026
Merged

AI driven algolia search#186
saif-at-scalekit merged 14 commits intomainfrom
preview/ai-search

Conversation

@saif-at-scalekit
Copy link
Collaborator

@saif-at-scalekit saif-at-scalekit commented Jul 29, 2025

  • Disable pagefind
  • Set up algolia crawler at scalekit-starlight-crawler
  • Set up crawler configuration
  • Set up Ask AI in private beta
  • Successfully test in Algolia playground
  • Retain the Header.astro and do not default import Search component. This imports pagefind component instead of algolia.
  • Wait for DocSearch v4 merge, and update the astro plugin

- Introduced the @astrojs/starlight-docsearch package to enhance search functionality.
- Updated astro.config.mjs to include starlightDocSearch configuration with appId, apiKey, and indexName.
- Disabled the previous pagefind configuration for improved search performance.
- Updated package.json and pnpm-lock.yaml to include the new dependency and its version.
…ionality

- Removed the disabled pagefind configuration from astro.config.mjs.
- Updated the indexName in starlightDocSearch configuration for better clarity.
- Upgraded @astrojs/starlight package from version 0.35.1 to 0.35.2 in package.json and pnpm-lock.yaml to ensure compatibility with the latest features.
@saif-at-scalekit saif-at-scalekit self-assigned this Jul 29, 2025
@saif-at-scalekit saif-at-scalekit added the tooling Purely tooling related change label Jul 29, 2025
@notion-workspace
Copy link

AI driven

@netlify
Copy link

netlify bot commented Dec 24, 2025

Deploy Preview for scalekit-starlight ready!

Name Link
🔨 Latest commit 270fced
🔍 Latest deploy log https://app.netlify.com/projects/scalekit-starlight/deploys/695dd95ad2196e0008df59bc
😎 Deploy Preview https://deploy-preview-186--scalekit-starlight.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

saif-at-scalekit and others added 7 commits December 24, 2025 17:24
Add DocSearch v4 support from dylantientcheu/starlight fork (PR #3346).
Only the docsearch package is vendored (44KB vs 34MB full repo).

Features:
- @docsearch/css and @docsearch/js v4.2.0
- Optional Ask AI support

See project-docs/DOCSEARCH_V4_MIGRATION.md for migration guide
when official release is available.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Move from vendor/starlight-docsearch-v4/packages/docsearch to vendor/docsearch
- Update package.json override to use simpler path
- Update migration documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Introduced the 'askAI' parameter in the Astro configuration for enhanced search capabilities.
- This addition allows integration with AI features for improved user experience.
@saif-at-scalekit saif-at-scalekit marked this pull request as ready for review January 7, 2026 03:49
@saif-at-scalekit saif-at-scalekit merged commit 384a014 into main Jan 7, 2026
4 checks passed
@saif-at-scalekit saif-at-scalekit deleted the preview/ai-search branch January 7, 2026 16:19
saif-at-scalekit added a commit that referenced this pull request Mar 3, 2026
* Add starlight-docsearch integration and update configuration (#180)

- Introduced the @astrojs/starlight-docsearch package to enhance search functionality.
- Updated astro.config.mjs to include starlightDocSearch configuration with appId, apiKey, and indexName.
- Disabled the previous pagefind configuration for improved search performance.
- Updated package.json and pnpm-lock.yaml to include the new dependency and its version.

* Update Astro configuration and dependencies for improved search functionality

- Removed the disabled pagefind configuration from astro.config.mjs.
- Updated the indexName in starlightDocSearch configuration for better clarity.
- Upgraded @astrojs/starlight package from version 0.35.1 to 0.35.2 in package.json and pnpm-lock.yaml to ensure compatibility with the latest features.

* chore: maintain the AI search

* feat: ai search in local package - vitual

* chore: bring it locally as long as it's released

* feat: add DocSearch v4 via vendor fork

Add DocSearch v4 support from dylantientcheu/starlight fork (PR #3346).
Only the docsearch package is vendored (44KB vs 34MB full repo).

Features:
- @docsearch/css and @docsearch/js v4.2.0
- Optional Ask AI support

See project-docs/DOCSEARCH_V4_MIGRATION.md for migration guide
when official release is available.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: simplify vendor docsearch structure

- Move from vendor/starlight-docsearch-v4/packages/docsearch to vendor/docsearch
- Update package.json override to use simpler path
- Update migration documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat: add Ask AI support to DocSearch configuration

- Introduced the 'askAI' parameter in the Astro configuration for enhanced search capabilities.
- This addition allows integration with AI features for improved user experience.

* chore: fix casing

* feat: remove the wip pages from crawler search

---------

Co-authored-by: Claude <noreply@anthropic.com>
saif-at-scalekit added a commit that referenced this pull request Mar 4, 2026
* updating docs

* Adds the banner to invite users to join the community (#297)

* feat: adds teh banner to invite users to join the community

* feat: enhance homepage styling and add community banner

* feat: add community banner component and update banner content across documentation

---------

Co-authored-by: Akshay Parihar <akshay.parihar@scalekit.com>

* Remove community banner from API reference page (#300)

* human mcp topology

* update title

* updates

* updates

* updates

* Update claims field description in auth-flow guide (#304)

Removed mention of ID tokens from claims field explanation.

* updates from review comments

* updates

* updating docs for token creation in custom auth

* updates

* Rename tool to tool_name in email fetch example (#306)

Amended parameter name in docs to match SDK Parameter.

* updating docs for custom auth with sdk support

* removing bold from sub and email in note

* fix pip install

* update conn id and lri

* updating placeholders

* Fixes the info about the ID tokens containing custom claims (#308)

* Clarify documentation on custom claims in ID tokens by specifying that claims are only included in ID tokens, not access tokens. Adjusted wording for consistency and clarity in the interceptor scenarios guide.

* Fix Steps component formatting in interceptor-scenarios.mdx

- Remove ### headers from step titles to comply with Steps component requirements
- Use **bold** formatting instead of headers for step titles
- This fixes the build error where Steps component expected single ordered list

* Use #### headers instead of bold formatting in Steps component

- Testing shows that #### headers work with Starlight's Steps component
- This provides better visual hierarchy while maintaining compatibility
- ### headers cause build errors but #### headers are acceptable

* Section about managing sessions remotely (#302)

* chore: start manage sessions remoately

* fix: update session management examples to use correct SDK methods and improve clarity

- Changed references from `scalekit.sessions` to `scalekit.session` in JavaScript, Python, Go, and Java examples.
- Updated filtering parameters to use consistent casing for status and improved date handling in Python and Go examples.
- Enhanced console output messages for revoked sessions to be more user-friendly.

* feat: remove the mention of passwordless

* Adds documentation for user management > user limits (#312)

* chore: start manage sessions remoately

* fix: update session management examples to use correct SDK methods and improve clarity

- Changed references from `scalekit.sessions` to `scalekit.session` in JavaScript, Python, Go, and Java examples.
- Updated filtering parameters to use consistent casing for status and improved date handling in Python and Go examples.
- Enhanced console output messages for revoked sessions to be more user-friendly.

* feat: remove the mention of passwordless

* fix: update SDK version in installation instructions

- Changed Gradle and Maven dependency versions from `2.0.1` to `2.0.6` for the Scalekit SDK.

* feat: add section for limiting user sign-ups in organization

- Introduced a new section in the manage organization guide detailing how to limit the number of users in an organization.
- Added an image to illustrate the process of updating organization settings for user limits.

* feat: add user limits image and update references in user management settings

- Added a new image for user limits in the user management settings documentation.
- Updated the manage organization guide to clarify how to limit the number of users in an organization.

* feat: enhance Scalekit API documentation with user management settings and environment details

- Updated the Scalekit API specification to include new user management settings for organizations, allowing for maximum user limits.
- Added detailed descriptions for development and production environments, including API URLs and subdomain variables.
- Improved formatting and organization of the Swagger JSON file for better readability and consistency.
- Clarified user limits in the manage organization guide, including a note on how limits affect user invitations.

* fix: clarify user provisioning limits in manage organization guide

- Updated the manage organization guide to specify that new user provisioning is blocked until organization limits are increased.
- Removed redundant instructions and improved clarity by consolidating steps related to configuring user limits.

* Refactor Swagger JSON for improved readability and consistency (#314)

- Reformatted the Swagger JSON file to enhance clarity by aligning array elements and object properties.
- Updated tags for various API endpoints to use consistent array formatting.
- Added a backup of the previous Swagger JSON file for reference.
- Ensured all descriptions and examples are properly structured for better documentation quality.

* Adds a clarifying note recommending against using Authentication in the MCP Inspector, as Dynamic Client Registration is the preferred approach (#313)

* Enhance FastMCP integration guide with additional context and clarification

- Updated the introduction to clarify the purpose of the guide and the steps involved in securing a FastMCP server with Scalekit.
- Added an Aside component to inform users about leaving the Inspector's Authentication fields empty to avoid errors with dynamic client registration.

* Update src/content/docs/mcp/integrations/fastmcp.mdx

* Adds new webhook reference for new event categories (#311)

* Refactor webhook documentation structure and add new event types

- Simplified sidebar configuration for webhooks by removing unnecessary nesting.
- Updated the order of the 'Directory events' section in the sidebar.
- Added new documentation files for 'Organization events', 'Permission events', 'Role events', 'Enterprise SSO events', and 'User events', detailing their respective webhook functionalities and JSON structures.
- Ensured all new sections include comprehensive descriptions and structured content for clarity.

* Add new webhook events and update documentation structure

- Introduced new webhook events: `organization.directory_created` and `organization.directory_deleted` with placeholders for future documentation.
- Updated section headings for consistency, changing 'Directory User Events' to 'Directory user events' and 'Directory Group Events' to 'Directory group events'.
- Standardized the heading format for SSO and user authentication events for improved clarity.

* Update webhook event documentation with new structures and examples

- Revised JSON structures for organization, permission, role, and user events to reflect updated identifiers and attributes.
- Enhanced descriptions for each event type, ensuring clarity on the purpose and data fields.
- Removed deprecated fields and added new ones, such as `external_id` and `settings.features`, to improve accuracy and usability.
- Standardized timestamps and organization details across all event types for consistency.

* Remove outdated overviewTitle from organization events documentation

* Enhance user event webhook documentation for clarity

- Updated descriptions for `user.signup`, `user.login`, `user.logout`, `user.organization_membership_created`, `user.organization_membership_updated`, and `user.organization_membership_deleted` to provide clearer context on the events.
- Ensured consistency in terminology and improved the understanding of each event's purpose and implications.

* Update image path for Redirect URI in Scalekit docs (#315)

* Add 'email' scope to Scalekit OIDC options

* Remove membership details from user webhook events

Removed membership details from user events in the webhook documentation.

* - Updated API endpoint descriptions and tags for consistency, including renaming the 'Organizations' endpoint to 'Connections'. (#320)

- Added new endpoints for resending user invitations and adding existing users to organizations, with detailed descriptions and parameters.
- Improved examples for SDK usage across various programming languages.
- Removed deprecated fields and ensured all definitions are up-to-date for better documentation quality.

* Iframe styles in iframe.css to hide theme toggle and enforce light color scheme

* updating docs for bring your own auth update user details

* Add documentation for managing MCP clients, including types, registration, and consent management

Updated Quickstart guide to reflect the new UI in place

* adding caution for fastmcp in quickstart

* adding scopes section in additional settings

* improve: the flow of the document is normalized and a better intro is set up (#330)

* change link expiry (#332)

* Clarify the generate admin portal usage (#334)

* Update Admin Portal documentation to clarify the usage of the Generate Portal Link API, including link expiration and session duration details.

* API reference updates (#335)

* change link expiry

* change link expiry

---------

Co-authored-by: avinash <avinash.kamath@scalekit.com>

---------

Co-authored-by: avinash <avinash.kamath@scalekit.com>

* change link expiry in response (#336)

* change link expiry in response

* chore: reorder the swagger spec

---------

Co-authored-by: Saif Ali Shaik <saif.shaik@scalekit.com>

* Enable PreSignup Interceptor to provision users

Enable PreSignup Interceptor to provision users

* Clarify comments in auth-flow-interceptors.mdx

Updated comments for clarity in auth-flow-interceptors.mdx.

* Fourth revision of docs.scalekit.com (#271)

- Major changes on how users navigate the docs. 
- Major changes to how users follow the content. 
- New experience for the home page and the samples.
- Well tested links and contents.

* chore: mobile updates changes (#339)

* Update home page title to reflect authentication focus (#342)

* Update home page title to reflect authentication focus

* chore: update sidebar configuration and enhance mobile styles

- Commented out the Sidebar component in astro.config.mjs for clarity.
- Added CSS rules to hide the TopicsDropdown on tablet and desktop layouts, displaying it only on mobile devices.

* updating quickstart for cimd

* updates to quickstart

* Update dependencies in package.json and pnpm-lock.yaml (#340)

- Bump versions for several packages including Astro, Expressive Code plugins, and others to their latest stable releases.
- Ensure compatibility with updated Node.js types and other related packages.
- Improve overall project stability and performance with these updates.

* restore: Revert README.md to Scalekit documentation (#343)

Revert README.md from vacuum project documentation back to Scalekit documentation.

This commit restores the README.md to commit 1da3432 which contained the appropriate
Scalekit documentation README instead of the vacuum OpenAPI linter documentation.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude <noreply@anthropic.com>

* Adds updates to webhooks, JIT, SSO and couple others (#341)

* Update the event reference for users and orgs

* chore: how to manage email domain rules in UI

* feat: add organization-level roles documentation and image

- Introduced a new section on configuring organization-specific roles in the create roles and permissions guide.
- Added an image to illustrate the process of adding organization roles in the Scalekit Dashboard.

* updating mcp overview

* Update sidebar configuration by removing outdated SSO guide links (#346)

* update for quickstart

* screenshot updates and feedback for byoa

* chore: update teh screenshot to add new claim (#344)

* pr comments

* update text to tip

* JIT, Organization domain update (#345)

* JIT and organization domain updates

* JIT and org domain changes

* Package.json sync

* undo

* Remove packageManager entry from package.json

* Update JIT provisioning documentation and sidebar configuration

- Added a new guide for Just-in-time (JIT) provisioning, detailing its configuration and management.
- Updated the sidebar to include a link to the new JIT provisioning guide.
- Revised the enterprise SSO documentation to enhance clarity on organization domains and JIT provisioning features.
- Adjusted headings and content structure for better organization and readability.

* Revise documentation guidelines and enhance SSO integration details

- Updated the enforcement level in CLAUDE.md to allow for flexibility based on content needs.
- Improved clarity in language rules, emphasizing direct instruction and active voice.
- Added a new image for user profile synchronization in the enterprise SSO documentation.
- Streamlined the SSO integration section, clarifying organization domain registration and testing procedures.
- Included best practices for JIT provisioning, highlighting the necessity of organization domains for automatic user account creation.

* Enhance enterprise SSO documentation and clarify JIT provisioning details

- Updated examples in the enterprise SSO guide to include specific user email addresses for clarity.
- Revised references to `login_hint` for consistency and accuracy in the FSA login implementation guide.
- Adjusted sidebar navigation links for better organization and user flow.
- Improved explanations regarding organization domains in JIT provisioning to ensure users understand the requirements for automatic provisioning.

* chore: comment to add JIT

* feat: add JIT provisioning flow diagram and enhance launch checklist

- Introduced a new SVG diagram illustrating the JIT provisioning flow for better visual understanding.
- Updated the launch checklist to include steps for registering organization domains, configuring user identifiers, setting default roles, and monitoring JIT activity.
- Revised the JIT provisioning documentation to clarify the process and requirements for automatic user creation during SSO logins.

* refactor: streamline enterprise SSO and JIT provisioning documentation

- Removed outdated content regarding automatic attribute sync from the enterprise SSO guide.
- Clarified the role of organization admins in managing JIT provisioning settings through the Admin Portal.
- Enhanced instructions for generating and sharing the Admin Portal with customers for SSO setup.

* Update JIT provisioning documentation

Removed details about JIT provisioning creating duplicate users and clarified the solution for user role assignments during JIT provisioning.

* Update enterprise-sso.mdx

When using FSA, 95% of times, B2B app will simply redirect user to login page without passing any identifier like login_hint etc. No need to add context on 'login_hint' in this guide.

It makes sense in Modular SSO but not in FSA SSO guide.

---------

Co-authored-by: Saif Ali Shaik <saif.shaik@scalekit.com>

* updates to note in quickstart

* renaming cimd to standard term

* [2025-W51] Weekly upgrades to docs.scalekit.com  (#350)

* chore: improve how we deploy d2 on netlify

* feat: removes dependency on the external plugin to customize the table of contents

* chore: fix the outdated lock file that preventing the build success

* feat: a health endpoint to monitor uptime

* chore: install netlify adaptor to support API endpoints to host

* chore: hide the list of .netlify files

* chore: add the agent connectors documentation

* updating screenshots

* added disable full-stack auth as the first step of instructions. (#352)

* added disable full-stack auth as the first step of instructions.

* Remove redundant info at this step

---------

Co-authored-by: saif-at-scalekit <saif.shaik@scalekit.com>

* [2025 W51] Fixes related to screenshot in OneLogin integration guide (#354)

* Add new images for OneLogin SAML integration guide and update references in documentation

* Update OneLogin SAML integration guide to enhance heading structure and add custom styles for improved readability

* [2025-W51] Updates to the copy in home page and the dropdown menu (#353)

* feat: update the content bits to the home page and menu

* refactor: enhance homepage content for clarity and conciseness

- Improved introductory text for better readability and flow.
- Streamlined descriptions for modular auth capabilities and added clarity on features.
- Adjusted image styling for better presentation.

* feat: add new image assets for homepage and update layout

- Introduced new SVG and PNG images for enhanced visual representation on the homepage.
- Adjusted layout spacing for improved aesthetics and user experience.

* feat: enhance footer and homepage content for improved user experience

- Added new icons to the footer for better visual representation.
- Updated footer links for clarity and consistency.
- Adjusted heading and paragraph styles on the homepage for improved readability.
- Modified icon keys in the documentation to reflect updated terminology.

* refactor: update homepage content for clarity and specificity

- Revised descriptions for real-time events and auditing purposes to enhance clarity and precision.
- Improved language to better reflect the functionality of the features.

* Rebrands to Agent Auth (major), badge fixes and more (#351)

* chore: hidden user_deleted event is not appearing in table of contents

* chore: updated every occurace of agent actions to agent auth

* chore: update agent actions to use agent auth (part 2)

* chore: remove the unncessary badge in sidebar.configs.json

* feat: sync the code snippet changes for custom code snippets

* chore: update Scalekit API documentation to reflect environment variable changes and fix CSS syntax

* feat: introduce Scalekit API documentation in YAML format and update Swagger JSON to reflect new endpoints and authentication details

* chore: update reorder-swagger script to use scalekit.scalar.json and add custom webhook slug generation logic

* chore: fix the undefined url for the webhook api reference

* chore: update sidebar configuration to include new how-to guides and reference items, and adjust webhook link for consistency

* feat: add Coffee Desk demo to full stack auth documentation with links to application and code

* chore: phrase it coffedesk app

* chore: fix teh secondary nav poitn to organiztion created for now

* feat: add new SVG diagrams for authentication and user management processes, enhancing visual documentation for better understanding

* chore: update Scalekit API documentation to include new webhook events for role and permission management, and adjust formatting for consistency

* chore: remove outdated Scalekit Swagger JSON file and its backup, streamlining API documentation management

* chore: update Swagger spec path to use scalekit.scalar.json for improved API documentation accuracy

* chore: format API documentation for consistency by updating tags and descriptions in scalekit.scalar.json and scalekit.scalar.yaml

* chore: comment out outdated webhook references in sidebar configuration to streamline navigation

* chore: update webhook documentation to replace sidebar configuration with topic tags for improved organization

* chore: enhance LLMs route configuration with memory and timeout constraints for improved serverless performance

* chore: enable prerendering for LLMs route and enhance error handling with validation checks for documentation paths

* Adds additional redirects from agent-actions paths (#355)

* Enhance agent actions redirects and improve URL handling in dynamic routes

* Added explicit fallback redirects for common agent actions paths to ensure consistency.
* Updated the GET handler in the dynamic route to construct absolute redirect URLs, improving reliability and handling of both array and string slug formats.

* Enhance agent actions redirects for improved URL consistency

* Added explicit redirects for various agent actions paths to ensure users are directed to the correct agent-auth pages.
* Organized redirects into categories: main pages, authentication pages, advanced pages, frameworks pages, MCP pages, and tools pages for better structure and maintainability.

* Refactor redirects configuration for authentication pages

* Updated the formatting of redirect paths for authentication pages to ensure consistency and readability.
* Organized the redirect entries for better maintainability and clarity in the configuration file.

* Refactor redirects configuration and remove unused agent actions page

* Updated the redirects configuration to clarify the handling of known routes and the role of dynamic routes as a safety net.
* Removed the unused `index.ts` file from the agent actions page, streamlining the codebase and improving maintainability.

* [2025 W52] improvements related to code snippets, accuracies and more (#359)

* chore: update the enterprise customers to link to UI events guide

* chore: include the link to admin portal events for UI from add modular sso guide.

* feat: optmize CLAUDE.md to refer to necessary files instead of loding EVERYTHING to memory

* chore: duplicate redirects are now removed

* Enhance M2M API documentation with comprehensive SDK support details for token validation across Node.js, Python, Go, and Java. Include methods and options for validating access tokens, while noting the continued use of standard JWT libraries for custom validation logic.

* chore: clearn up the mistakes of code snippets with it come to singular /plurals

* chore: hide unlisted pages from the search results

* feat: script that hides pages that are unlinked in sidebar

* chore: accidentally hid, because of custom slug attached

* [2025-W51] Navigation updates to SDKs & APIs from secondary navbar (#357)

* Update webhook documentation and SVG assets for improved clarity and organization

* Removed outdated webhook overview documentation to streamline content.
* Updated the sidebar configuration to reflect the new focus on webhooks, renaming sections for better clarity.
* Enhanced the listen-to-webhooks guide with additional event references and improved diagram assets for better understanding of webhook flows.
* Adjusted the SVG assets to ensure consistency in design and updated dimensions for better presentation.

* Add webhook handling documentation and update redirects

* Introduced a new guide on handling webhook events in Scalekit, detailing setup, processing, and signature verification.
* Updated existing redirects to point to the new webhook handling guide, ensuring users are directed to the correct resources.
* Enhanced the structure and clarity of webhook event processing examples across multiple programming languages.
* Included best practices for responding to webhook events and testing webhook implementations.

* Update webhook documentation and SVG assets for improved clarity and organization

* Added a new SVG diagram for handling webhook events to enhance visual understanding.
* Updated the sidebar configuration to reflect changes in webhook documentation, including renaming sections for better clarity.
* Removed outdated webhook handling guide to streamline content and improve navigation.
* Adjusted the existing webhook implementation guide to align with the new structure and ensure consistency across documentation.

* Update webhook references in documentation and configuration

* Updated sidebar configuration to exclude additional paths for improved navigation.
* Removed outdated SVG assets related to webhook handling to streamline content.
* Revised documentation links to point to the new webhook implementation guide for better clarity and accessibility.
* Enhanced the quickstart guide to reflect the updated webhook resources, ensuring users have access to the latest information.

* chore: remove the conflicting path

* chore: remove duplicates with extra trailing slash

* chore: new api reference left top nav

* fix: update secondary navigation for improved path handling

* Removed the 'current' class from all dropdown items to ensure accurate highlighting of the active navigation state.
* Updated the href for the REST APIs item to point directly to the overview section, enhancing user navigation and clarity.

* refactor: replace changelog handling with GitHub releases loader

* Removed the starlight-changelogs dependency and its related configurations.
* Integrated the astro-loader-github-releases for fetching SDK releases.
* Updated sidebar and navigation links to reflect the new SDKs & APIs structure.
* Added new redirects for changelog paths to the SDK overview page, enhancing user navigation.

* chore: see the node and change log sdk

* chore: sdk relases

* chore: update the class names to track the chagnes more closly

* chore: update SDK FoldCard components to enhance descriptions and layout

* Increased the flex basis of the SDK header section for better layout.
* Added descriptive paragraphs to each SDK FoldCard, highlighting key features and benefits for Node.js, Python, Go, and Java clients.

* chore: improve the visibility of 3 cards together

* chore: update SDK layout and actions for improved user experience

* Adjusted the flex basis of the API header section for better alignment.
* Simplified SDK action links to enhance clarity and accessibility.
* Enhanced FoldCard components with subtitles and structured bottom rows for clearer feature presentation and navigation.

* chore: update SDK description for clarity and accuracy

* Revised the description of the Node.js SDK to be more TypeScript-friendly and specific to modern Node.js based applications.

* chore: add starlight-package-managers dependency and enhance FoldCard component

* Added the starlight-package-managers package to package.json for improved package management.
* Enhanced the FoldCard component to support icon positioning, allowing for better layout flexibility.
* Updated the Node.js SDK page to include installation instructions and display the latest release information with improved formatting.

* chore: restructure SDK documentation and update sidebar configuration

* Removed outdated SDK pages for Go, Java, Node.js, and Python to streamline content.
* Added new Go, Java, Node.js, and Python SDK pages with detailed installation instructions and release information.
* Updated sidebar configuration to reflect the new structure and improve navigation for SDKs.

* chores: apply the feedback related to aesthetics

* chore: refactor SDK page to utilize helper functions and improve styling

* Introduced utility functions for fetching the latest SDK releases and formatting time strings.
* Simplified the SDK configuration by leveraging the new helper functions.
* Added a dedicated CSS file for SDK page styles to enhance layout and visual consistency.

* update: move from legacy passthroughimage service

* chore: fix type errors

* chore: updated the cards to bring the change to the left

* feat: upgrades to the card layout eliminating the linkbutton

* fixed link to status page in the footer

* Add agent authentication code samples and update sidebar configuration

* Introduced a new documentation file for agent authentication code samples, showcasing integrations with LangChain, Google ADK, and Slack tools.
* Updated the main index file to export the new agent authentication code samples component.
* Modified the sidebar configuration to include a new 'Code samples' section under agent authentication for improved navigation.

* Two guides, whitelabelled - Shibolleth and Google SAML (#363)

* chore: fix and make the guides white-labelled

* fix: update note for clarity in Google SAML integration guide

* [2025-W52] Previewing the organizing experiments to the developer resources sidebar (#358)

* wip: experiment with navbar

* feat: adds new placeholder files

* feat: the size of items spaced out in the sidebar

* chore: the styles or size section header

* feat: hide teh integrations collapsible

* chore: fix the spacing rems

* feat: bring code samples together

* feat: bring code samples into picture of fsa

* feat: add cards to improve the openapi-spec

* feat: bring back ai assisted set up guide

* fix: update sidebar path for ai-assisted setup guide

* chore: updates to dysfunctional configuration with sidebar topics

* fix: update sidebar links to point to external documentation

* fix: add rel attributes to external links and update sidebar labels for clarity

* chore: comment out sidebar items for future implementation

* Update sidebar links and icons for improved navigation and clarity (#365)

- Changed the link for 'Full stack auth' to point to the quickstart guide.
- Updated the icon for 'Agent Auth' to a more relevant representation.
- Revised the link for 'Developer Resources' to direct users to the code samples section.
- Adjusted the link for 'Modular SCIM' to lead to the quickstart guide.
- Updated the icon for 'SDKs & APIs' for better visual consistency.

* Add initiate login url setup in FSA quickstart (#364)

* Add initiate login url setup in FSA quickstart

* Content change

* Added example scenarios for initiate login url

Added example scenarios where initiate login url of the application is required.

* Enhance initiate-login URL description with link

Added a link to the initiate-login URL explanation.

* Update FSA quickstart guide to clarify redirect URL setup and improve authorization URL instructions

* Refactor FSA quickstart guide to streamline section titles and improve clarity in user flow instructions

* Clarify authorization URL description in FSA quickstart guide to enhance user understanding of its purpose and usage.

* Enhance FSA quickstart guide by adding a description for creating an authorization URL, improving user understanding of the login process.

---------

Co-authored-by: Saif Ali Shaik <saif.shaik@scalekit.com>

* Update 'Initiate-login URL' description for clarity

Clarified the explanation of the 'Initiate-login URL' in the documentation.

* feat: tells google search engine to no index these pages on the google search. These are unlisted pages. (#366)

* fix: swap SCIM and SSO integration links in sidebar configuration for accurate navigation (#368)

* feat: upgrade to starlight and other npm packages (#369)

* Update claim description from ID to Access tokens

Update claim description from ID to Access tokens

* AI driven algolia search (#186)

* Add starlight-docsearch integration and update configuration (#180)

- Introduced the @astrojs/starlight-docsearch package to enhance search functionality.
- Updated astro.config.mjs to include starlightDocSearch configuration with appId, apiKey, and indexName.
- Disabled the previous pagefind configuration for improved search performance.
- Updated package.json and pnpm-lock.yaml to include the new dependency and its version.

* Update Astro configuration and dependencies for improved search functionality

- Removed the disabled pagefind configuration from astro.config.mjs.
- Updated the indexName in starlightDocSearch configuration for better clarity.
- Upgraded @astrojs/starlight package from version 0.35.1 to 0.35.2 in package.json and pnpm-lock.yaml to ensure compatibility with the latest features.

* chore: maintain the AI search

* feat: ai search in local package - vitual

* chore: bring it locally as long as it's released

* feat: add DocSearch v4 via vendor fork

Add DocSearch v4 support from dylantientcheu/starlight fork (PR #3346).
Only the docsearch package is vendored (44KB vs 34MB full repo).

Features:
- @docsearch/css and @docsearch/js v4.2.0
- Optional Ask AI support

See project-docs/DOCSEARCH_V4_MIGRATION.md for migration guide
when official release is available.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: simplify vendor docsearch structure

- Move from vendor/starlight-docsearch-v4/packages/docsearch to vendor/docsearch
- Update package.json override to use simpler path
- Update migration documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat: add Ask AI support to DocSearch configuration

- Introduced the 'askAI' parameter in the Astro configuration for enhanced search capabilities.
- This addition allows integration with AI features for improved user experience.

* chore: fix casing

* feat: remove the wip pages from crawler search

---------

Co-authored-by: Claude <noreply@anthropic.com>

* Update title for Azure AD SAML documentation (#371)

* Full access token example: adds custom claims (#372)

* feat: decoded access token example with custom claims

* add markers for better understanding

* Enhance Full Stack Auth documentation: update Next.js example link and add FastAPI authentication template (#375)

- Updated the Next.js example link to point to the correct repository.
- Introduced a new FastAPI authentication template with details on user sessions and route protection.

* docs(interceptors): clarify that either external_organization_id or organization_id is required

* Added interceptor example for user provisioning

* Package.json changes reverted

* Reverted changes to package.json

* Revert changes to package.json

* Revert changes to package.json

* docs(interceptors): clarify required org id fields and format B2B example

* docs: add pre-signup interceptor example for org provisioning

* Improved code bloacks

* improved code blocks

* docs: add firewall and network configuration to launch checklist

Add network and firewall configuration section to the enterprise features
in the launch checklist. This restores the previously removed FAQ about
which Scalekit domains need to be whitelisted for customers deploying
behind corporate firewalls or VPNs.

Changes:
- Add "Network & firewall configuration" subsection under Enterprise features
- Include expandable details table with required domains (environment URL, CDN, docs, fonts)
- Add checklist items for verifying firewall access and testing from customer network
- Provide guidance on where to find the actual environment URL in dashboard

This helps enterprise customers and their IT teams properly configure
network access before production deployment.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* List the domains to be allowlisted for sso/scim in private infra scenarios (#379)

* Update enterprise network configuration checklist

Refines the enterprise features section by clarifying network and firewall configuration steps, moving checklist items outside of details, and improving instructions for whitelisting Scalekit domains. Removes redundant checklist items and streamlines guidance for customers deploying behind firewalls or VPNs.

* Hides sso specific launch checklist

FSA related checklist already exists

* fix(security): address 10 open Dependabot alerts (#380)

* fix(security): address 10 open Dependabot alerts

Updates vulnerable dependencies and adds pnpm overrides to force secure versions:

- @modelcontextprotocol/sdk: 1.25.1 → 1.25.2 (fixes ReDoS vulnerability GHSA-8r9q-7v3j-jr4g)
- glob: 10.5.0 → 11.0.3 via override (fixes command injection GHSA-5j98-mcp5-4vw2)
- jws: 3.2.2 → 3.2.3 (fixes HMAC signature verification GHSA-869p-cjfg-cm3x)
- node-forge: 1.3.1 → 1.3.3 (fixes ASN.1 vulnerabilities GHSA-5gfm-wpxj-wjgq, GHSA-554w-wpv2-vw27)
- qs: 6.14.0 → 6.14.1 (fixes arrayLimit bypass GHSA-6rw7-vpxm-498p)
- mdast-util-to-hast: 13.2.0 → 13.2.1 via override (fixes GHSA-4fh9-h7wg-q85m)

* chore: update dependencies and add script for checking pnpm overrides

- Upgrade `strip-ansi` from 7.1.0 to 7.1.2 to address potential vulnerabilities.
- Update `ansi-styles` dependency in `wrap-ansi` from 6.2.1 to 6.2.3.
- Introduce a new script `check-overrides.sh` to verify if pnpm overrides are still necessary, enhancing proactive security measures against vulnerabilities.

* Descriptions for domain management endpoints (#376)

* Refactor Scalekit API documentation for clarity and consistency

- Adjusted formatting and indentation in the `scalekit.scalar.yaml` file for improved readability.
- Enhanced descriptions for domain management endpoints, clarifying the purpose and usage of ALLOWED_EMAIL_DOMAIN and ORGANIZATION_DOMAIN.
- Updated code examples across various SDKs to ensure consistent formatting and accuracy.
- Added new endpoint for retrieving details of the currently authenticated user.

* Removed unwanted descriptio

* Updated docs changes

---------

Co-authored-by: AashishMehtoliya01 <aashish.mehtoliya@scalekit.com>

* [2026 W2] Experience updates related to launch checklists (#381)

* Add override management docs and check script

Introduces OVERRIDES_MANAGEMENT.md to document pnpm override practices and adds scripts/check-overrides.sh to proactively check for stale or unnecessary overrides. Also updates the launch checklist title for clarity and removes the Slack banner from the SSO integrations guide.

* Reorder Go Live sidebar items

Moved 'authenticate/launch-checklist' below 'guides/dashboard/auth-logs' in the Go Live section of the sidebar configuration for improved navigation.

* Reorganize and expand authentication launch checklist

Restructured the authentication launch checklist for better logical flow, starting with defining requirements and progressing through core flows, enterprise features, customization, and user/org management. Added and clarified checklist items, merged and reordered sections, and improved descriptions to guide teams through production readiness.

* Add 'View all integrations' to sidebar

A new sidebar entry labeled 'View all auth integrations' linking to 'guides/integrations' was added to improve navigation to authentication integration guides.

* Update launch-checklist.mdx

* Update astro-og-canvas dependency to version 0.10.0 and modify OGImageRoute export to use await for improved functionality.

* Add 'Go live' section to sidebar and update launch checklists

Introduced a new 'Go live' entry in the sidebar for both SSO and SCIM launch checklists, enhancing navigation for users preparing for production deployment. Updated descriptions in the launch checklists to focus on SCIM and SSO-specific configurations, ensuring clarity and relevance for enterprise customers. Improved checklist items to reflect best practices for security, testing, and configuration readiness.

* Add Django authentication template to full stack auth examples

Introduced a new FoldCard for Django projects in the full stack authentication documentation, featuring session management, hosted login flow, and middleware-based route protection. Updated the icon mapping to use the appropriate Django icon for consistency across examples.

* Add CODEOWNERS file for repository ownership management

Introduced a new CODEOWNERS file to define default owners for the repository. This file specifies that @saif-at-scalekit and @ravibits will be automatically requested for review on all pull requests, streamlining the review process and ensuring accountability.

* Refactor launch checklists for SCIM and SSO

Updated the launch checklists for SCIM and SSO by removing unnecessary metadata and reorganizing checklist items for clarity. Enhanced descriptions for each checklist item to ensure they provide clear guidance on configuration and testing requirements for enterprise customers. This improves the overall usability and effectiveness of the documentation.

* Update sidebar configuration and launch checklist titles for clarity (#382)

* Update sidebar configuration and launch checklist titles for clarity

- Reordered sidebar items in the Go Live section to improve navigation.
- Changed titles and labels in the launch checklist documents from "Production launch checklist" to "Production readiness checklist" for better alignment with content focus.

* Only requests reviews automatically, doesn't not block PR from merging until atleast with approval

* Update CODEOWNERS to include @ravibits as a default reviewer for all pull requests

* Add FastAPI and Flask authentication templates to full stack auth examples

- Updated the icon mapping to include FastAPI and Flask icons.
- Introduced new FoldCards for FastAPI and Flask authentication templates, detailing session management and hosted login flows.
- Added a FoldCard for Express authentication, enhancing the full stack auth documentation with additional frameworks.

* Update icon mapping for Full Stack Auth documentation

- Changed the icon key for the Spring Boot FoldCard from "java" to "springboot" to ensure consistency with the framework's branding.

* updated Okta SSO setup to follow current Okta UI

* updated Okta SSO setup to follow current Okta UI

* replaced 21.png with the correct image

* changed 21.png to reflect the correct image and updated the instructions in okta-saml.mdx to specifiy what to do in 21.png

* Guide on implementing organization switcher (#385)

* Update full stack auth examples and add organization switching guide

- Updated the links for the Full Stack Auth with Next.js example to point to the correct repository.
- Added new FoldCards for FastAPI, Flask, Django, and Express authentication templates, enhancing the full stack auth documentation.
- Introduced a new guide for organization switching, detailing how users can switch between multiple organizations within the application.
- Updated sidebar and redirects configuration to include the new organization switching guide for improved navigation.

* Remove noindex meta tag from organization switching guide for improved SEO

* Refactor organization switching guide for clarity and improved user instructions

- Updated the introduction to clearly explain the purpose of organization switching.
- Enhanced the list of common scenarios for better readability and context.
- Simplified the steps for organization switching during authentication.
- Consolidated information on customizing the organization switcher's behavior.
- Improved code examples for various tech stacks to include use case comments and better formatting.

* Add common logout scenarios and clarify logout endpoint usage in FSA (#383)

* Add common logout scenarios and clarify logout endpoint usage in FSA documentation

- Introduced a section detailing common logout scenarios, including the appropriate endpoints for user logout and token revocation.
- Added explanations on why logout must be a browser redirect and provided code examples for both correct and incorrect usage.
- Included troubleshooting tips for session clearing issues post-logout, enhancing user guidance for effective session management.

* Clarify logout endpoint usage in FSA documentation

- Updated the logout guide to specify the use of `/oidc/logout` (end_session_endpoint) for user logout functionality, emphasizing the need for a browser redirect.
- Removed redundant information regarding the `/oauth/revoke` endpoint in the troubleshooting section to streamline guidance for users.

* Remove redundant checklist item for JIT provisioning in SSO launch checklist to streamline guidance for users. This update focuses on enhancing clarity and usability of the document.

* Add production environment verification to launch checklists

- Included a checklist item in the authentication, SSO, and directory launch checklists to verify that the production environment configuration (environment URL, client ID, and client secret) matches the production settings in the Scalekit dashboard.
- Enhanced clarity and usability of the launch checklists by ensuring users confirm their production configurations before going live.

* Enhance logout documentation in FSA guide

- Clarified the logout flow by emphasizing that cookies are cleared after extracting the ID token and generating the logout URL.
- Added a note explaining the necessity of using a browser redirect for the `/oidc/logout` endpoint, ensuring the session cookie is sent automatically for proper session termination.
- Updated code examples to consistently use `scalekitClient` for authorization URL generation across multiple programming languages.

* Clarify logout URL generation in FSA logout guide

- Updated the logout documentation to specify that the generated Scalekit logout URL points to the `/oidc/logout` endpoint.
- Enhanced code comments across multiple programming languages to reflect this change, ensuring clarity in the logout flow process.

* Add Laravel demo app to Full Stack Auth code samples (#388)

- Added Laravel icon import and mapping to icon-map.ts
- Added Laravel FoldCard to _fsa-code-samples.mdx template
- Links to https://github.com/scalekit-inc/scalekit-laravel-auth-example

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: saifshine7 <saifshine7@gmail.com>

* Session policy documentation (#389)

* Add FAQ about configuring access token lifetime in session policy

- Added new FAQ section explaining how to configure access token lifetime
- Instructions to navigate to Dashboard > Authentication > Session Policy
- Converted existing Aside components to FAQ format for consistency

Co-authored-by: saifshine7 <saifshine7@gmail.com>

* Update routing precedence naming and add CSRF guide link

- Changed connection_id to connectionId (or connection_id) for consistent camelCase style
- Added clickable link to authentication best practices guide for CSRF protection

Co-authored-by: saifshine7 <saifshine7@gmail.com>

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: saifshine7 <saifshine7@gmail.com>

* Update video link in FSA quickstart page (#390)


Co-authored-by: saifshine7 <saifshine7@gmail.com>

* feat: we now prerender the llms.txt (#392)

* Enhance authentication dropdown behavior in secondary navigation (#394)

- Updated the getDisplayLabel and getDisplayIcon functions to maintain the "Choose product" placeholder in the authenticate dropdown unless a child item is active. This prevents implicit label changes when users land on non-auth sections.
- Improved icon handling to ensure the correct icon is displayed based on the active child item, enhancing user experience in navigation.

* Add PingIdentity integration guide for SCIM (#395)

* Add PingIdentity integration guide and related images

- Introduced a new guide for syncing the PingIdentity directory with applications using SCIM, detailing the setup process and key components.
- Added multiple images to support the guide, including credential generation, connection setup, and rule configuration.
- Updated existing SCIM integration guides for Azure, Google, Okta, and OneLogin to reflect changes in terminology from "Directory Sync" to "SCIM Provisioning" for consistency.

* Add images and update descriptions in PingIdentity SCIM integration guide

- Added new images for connection setup, name and description fields, and configuration settings to enhance the PingIdentity SCIM integration guide.
- Updated existing image descriptions for clarity and context, ensuring users understand the visual aids provided in the setup process.

* Update FSA quickstart page to enhance demo visibility and add new integration video (#398)

* Documentation improvements [2026-W3] (#404)

* feat: add run scripts for node and python

* incorporate: beakdown setting mcp server and code editors as seperate sections

* Update FSA quickstart guide to include details on registering redirect URLs in the Scalekit dashboard and improve code example titles for clarity across multiple languages.

* Update FSA quickstart guide to improve code example titles for clarity across multiple languages, specifying file paths in the code snippets for better context.

* Adds expo sdk and reference documentation within docs.scalekit.com (#403)

* Add Expo SDK support to documentation and configuration

- Introduced the Expo SDK to the Scalekit documentation, including a new page detailing installation and usage.
- Updated sidebar configuration to include a link to the Expo SDK.
- Enhanced the content configuration to support the Expo SDK in the SDK collection.
- Added Expo icon mapping for better visual representation in the UI.
- Implemented release helper functions to fetch and display the latest Expo SDK releases.

* Add SDK reference documentation for Node.js, Python, Go, and Java

- Introduced new pages for the SDK reference documentation of Node.js, Python, Go, and Java, enhancing the Scalekit documentation.
- Implemented a custom GitHub files loader to fetch specific files from SDK repositories.
- Updated the sidebar configuration to include links to the new SDK reference pages.
- Enhanced content configuration to support the new SDK references collection, ensuring users have access to complete API documentation for each SDK.

* Scalekit .env documentation (#401)

* Add .env configuration snippet to Step 2 of Add Modular SSO guide

Appended the environment API credentials setup instruction with .env file
example to the 'Set up Scalekit' step, making it clearer for developers
to configure their credentials alongside SDK installation.

Co-authored-by: saifshine7 <saifshine7@gmail.com>

* Apply sentence casing to MCP server heading

Changed 'Set up Scalekit MCP Server' to 'Set up Scalekit MCP server'
to follow documentation sentence casing standards.

Co-authored-by: saifshine7 <saifshine7@gmail.com>

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: saifshine7 <saifshine7@gmail.com>

* Scalekit credentials quickstart (#400)

* Add Scalekit credentials setup reminder to quickstart

Co-authored-by: saifshine7 <saifshine7@gmail.com>

* Replace credentials link with .env code snippet

Co-authored-by: saifshine7 <saifshine7@gmail.com>

* Add language identifiers to Windsurf code fences

Co-authored-by: saifshine7 <saifshine7@gmail.com>

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: saifshine7 <saifshine7@gmail.com>

* Add Slack bot functionality and Algolia integration (#406)

* Add Slack bot functionality and Algolia integration

- Introduced a new Slack bot handler in `slack-bot.ts` to process app mention events and respond with answers from Algolia's AskAI.
- Added utility functions for verifying Slack signatures, posting messages, and parsing payloads.
- Implemented Algolia configuration and response handling in `algolia.ts`, enabling the bot to fetch conversation tokens and stream answers.
- Created type definitions in `types.ts` for better type safety and clarity in function parameters and responses.
- Updated `netlify.toml` to configure functions directory and node bundler for deployment.

This update enhances the Scalekit integration with Slack, allowing for dynamic responses to user queries through the AskAI service.

* Enhance Algolia configuration and request handling

- Added optional `referer` field to the Algolia configuration interface for improved request tracking.
- Updated `getAlgoliaConfig` function to include the `referer` in the returned configuration object.
- Refactored the `fetchConversationToken` function to use `buildAlgoliaTokenHeaders` for better header management.
- Simplified the request body structure in `streamAskAiAnswer` by using a separate `requestBody` object.
- Improved SSE stream handling by parsing Vercel AI SDK Data Stream Protocol prefixes for better response management.

These changes enhance the integration with Algolia's AskAI service, providing more flexibility and clarity in API interactions.

* Enhance Slack message posting functionality

- Added error handling to the `postSlackMessage` function to throw an error when the Slack API returns an error or the request fails.
- Implemented a timeout mechanism using `AbortController` to prevent hanging requests.
- Updated documentation to include the new error handling and timeout features.

These changes improve the reliability and robustness of the Slack integration, ensuring better error management during message posting.

* Log assistant ID usage in Algolia configuration

- Added a console log statement in the `getAlgoliaConfig` function to output the assistant ID being used. This change aids in debugging and provides clarity on which assistant ID is being utilized during the configuration process.

This update enhances the visibility of the configuration details, making it easier for developers to track the assistant ID in use.

* Enhance Slack bot and Algolia integration documentation

- Added comprehensive documentation comments to `slack-bot.ts`, `algolia.ts`, and `types.ts` files, detailing the purpose, key dependencies, and usage of each module.
- Included information on environment variable requirements and error handling for better clarity and guidance for developers.

These updates improve the maintainability and usability of the Slack bot integration with Algolia, ensuring developers have clear instructions and context for the codebase.

* Functions slackbot 2 (#407)

* Add Slack bot functionality and Algolia integration

- Introduced a new Slack bot handler in `slack-bot.ts` to process app mention events and respond with answers from Algolia's AskAI.
- Added utility functions for verifying Slack signatures, posting messages, and parsing payloads.
- Implemented Algolia configuration and response handling in `algolia.ts`, enabling the bot to fetch conversation tokens and stream answers.
- Created type definitions in `types.ts` for better type safety and clarity in function parameters and responses.
- Updated `netlify.toml` to configure functions directory and node bundler for deployment.

This update enhances the Scalekit integration with Slack, allowing for dynamic responses to user queries through the AskAI service.

* Enhance Algolia configuration and request handling

- Added optional `referer` field to the Algolia configuration interface for improved request tracking.
- Updated `getAlgoliaConfig` function to include the `referer` in the returned configuration object.
- Refactored the `fetchConversationToken` function to use `buildAlgoliaTokenHeaders` for better header management.
- Simplified the request body structure in `streamAskAiAnswer` by using a separate `requestBody` object.
- Improved SSE stream handling by parsing Vercel AI SDK Data Stream Protocol prefixes for better response management.

These changes enhance the integration with Algolia's AskAI service, providing more flexibility and clarity in API interactions.

* Enhance Slack message posting functionality

- Added error handling to the `postSlackMessage` function to throw an error when the Slack API returns an error or the request fails.
- Implemented a timeout mechanism using `AbortController` to prevent hanging requests.
- Updated documentation to include the new error handling and timeout features.

These changes improve the reliability and robustness of the Slack integration, ensuring better error management during message posting.

* Log assistant ID usage in Algolia configuration

- Added a console log statement in the `getAlgoliaConfig` function to output the assistant ID being used. This change aids in debugging and provides clarity on which assistant ID is being utilized during the configuration process.

This update enhances the visibility of the configuration details, making it easier for developers to track the assistant ID in use.

* Enhance Slack bot and Algolia integration documentation

- Added comprehensive documentation comments to `slack-bot.ts`, `algolia.ts`, and `types.ts` files, detailing the purpose, key dependencies, and usage of each module.
- Included information on environment variable requirements and error handling for better clarity and guidance for developers.

These updates improve the maintainability and usability of the Slack bot integration with Algolia, ensuring developers have clear instructions and context for the codebase.

* Enhance logging and error handling in Slack bot and Algolia integration

- Added detailed console logging in `slack-bot.ts` to track incoming requests, signature verification, and processing steps, improving visibility into the bot's operations.
- Implemented additional error handling for missing environment variables and JSON parsing failures, ensuring clearer feedback for developers during runtime.
- Updated `getAlgoliaConfig` in `algolia.ts` to log configuration details, aiding in debugging and providing context for the Algolia integration.

These enhancements improve the robustness and maintainability of the Slack bot and Algolia integration, facilitating easier troubleshooting and better operational insights.

* Comprehensive logging for function logs  (#408)

* feat(slack-bot): use Netlify Background Functions for AskAI processing

- Split slack-bot into main handler and background worker
- Main handler validates Slack requests and returns 200 OK immediately
- Background worker (slack-bot-worker-background.ts) handles AskAI calls
- The -background suffix enables Netlify Background Functions (15 min timeout)
- Fixes issue where context.waitUntil was unavailable in production

* fix: correct template literal syntax in background worker

* debug: add logging to diagnose background worker invocation

* refactor(slack-bot): use context.waitUntil instead of separate background worker

Migrate to Netlify Functions 2.0 format and inline the background
processing using context.waitUntil. This eliminates the need for a
separate worker file and simplifies the architecture.

- Use Request/Response instead of legacy event format
- Inline AskAI processing with waitUntil for background execution
- Add postSlackMessage to directly post answers to Slack
- Remove slack-bot-worker-background.ts (no longer needed)

Co-Authored-By: Claude (glm-4.7) <noreply@anthropic.com>

* chore: add husky and pretty-quick for pre-commit formatting

Co-Authored-By: Claude (glm-4.7) <noreply@anthropic.com>

* refactor(slack-bot): consolidate background processing into main handler

- Removed the separate background worker function (slack-bot-worker-background.ts) and integrated its logic into the main Slack bot handler.
- Utilized context.waitUntil for asynchronous AskAI processing, allowing immediate responses to Slack while handling requests in the background.
- Updated the handler to manage Slack events directly, improving efficiency and reducing complexity in the codebase.
- Enhanced error handling and logging for better visibility during processing.

* chore: update Netlify configuration and enhance Slack bot logging

- Added `included_files` to `netlify.toml` to ensure Functions 2.0 format is used.
- Improved logging in `slack-bot.ts` for better visibility during background processing, including detailed error handling and status messages for Slack interactions.

---------

Co-authored-by: Claude (glm-4.7) <noreply@anthropic.com>

* Config driven management for llms.txt (#393)

* Add starlight-llms-txt integration for LLM-friendly documentation generation

- Introduced starlight-llms-txt to the Astro configuration for generating LLM-friendly documentation.
- Added project name and description for Scalekit, outlining key features and considerations for LLMs.
- Removed deprecated llms.txt and llms-full.txt files along with their associated utility functions to streamline documentation generation.

This update enhances the Scalekit documentation's accessibility for LLMs, ensuring a more structured and informative output.

* Refactor LLM configuration for Scalekit documentation

- Introduced a new `llms.config.ts` file to encapsulate LLM-related configuration details, enhancing modularity and maintainability.
- Updated the Astro configuration to utilize the new `llmsConfig`, streamlining the integration of LLM-friendly documentation generation.
- Retained the project name and description for Scalekit, ensuring clarity in the documentation's purpose and focus areas.

This update improves the structure of the documentation configuration, making it easier to manage and extend in the future.

* Update package dependencies and lockfile for improved stability

- Bump versions of several dependencies including `@astrojs/netlify`, `@astrojs/starlight`, and `@expressive-code` plugins to their latest releases for enhanced features and bug fixes.
- Update `vue`, `react`, and `prettier` to ensure compatibility with the latest versions and improvements.
- Adjust `pnpm-lock.yaml` to reflect the updated dependency versions, ensuring a consistent environment across installations.

This update enhances the overall stability and performance of the project by keeping dependencies up to date.

---------

Co-authored-by: Cursor <cursoragent@cursor.com>

* Update package dependencies and lockfile for improved stability (#409)

- Bump versions of several dependencies including `@astrojs/starlight`, `@iconify/json`, `@scalar/api-reference`, and `@scalar/astro` to their latest releases for enhanced features and bug fixes.
- Update `react`, `react-dom`, and `prettier` to ensure compatibility with the latest versions and improvements.
- Adjust `pnpm-lock.yaml` to reflect the updated dependency versions, ensuring a consistent environment across installations.

This update enhances the overall stability and performance of the project by keeping dependencies up to date.

* overview, web, spa, native docs for multiapp

* fixing links

* updating links

* update quick start agent auth

* manage apps page

* scalekit manage apis

* add nodejs in quick start

* Update Node.js package version and method name

* Update Node.js snippet to handle authorizationDetails protobuf oneof structure (#414)

* Initial plan

* Update Node.js code snippet in agent auth quickstart Step 4 to use explicit authorizationDetails pattern

Co-authored-by: Avinash-Kamath <80739901+Avinash-Kamath@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Avinash-Kamath <80739901+Avinash-Kamath@users.noreply.github.com>

* Improve multi-app authentication docs structure and content

- Rename "Multi-App SSO" to "Multi-App Authentication" to avoid confusion with Enterprise SSO
- Add problem/solution framing and decision matrix to overview
- Add prerequisites, error handling, and security sections to implementation guides
- Add troubleshooting section to overview
- Add "What's next" sections to all guides
- Fix navigation order: Overview → Web App → SPA → Native → Manage Apps
- Standardize terminology across all files

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix import statement for ScalekitClient

* Add SCIM provisioning docs and diagrams

* Incorporating feedback from Coderabbit/Copilot

* Resolve copilot suggestions

* Resolve copilot suggestions

* Add Scalekit dryrun tool documentation and assets (#412)

* Add Scalekit dryrun tool documentation and assets

- Introduced `scalekit-dryrun`, an NPX-runnable CLI tool for testing Scalekit authentication flows without writing code.
- Added detailed documentation covering setup, usage, and common error scenarios.
- Included a new SVG diagram illustrating the authentication flow and a user profile details image for visual reference.
- Updated sidebar configuration to include the new dryrun tool for easier navigation.

This addition enhances the Scalekit documentation by providing a practical tool for developers to verify their authentication setup before implementation.

* Add links to related resources in Scalekit dryrun documentation

- Added a 'see also' section with links to the Scalekit dryrun GitHub repository and the npm package for better resource accessibility.
- Included an icon for the npm link to enhance visual representation.

This update improves the documentation by providing direct access to relevant resources, aiding developers in finding additional information quickly.

* Update user profile details image alt text in Scalekit dryrun documentation

- Changed the alt text for the user profile details screenshot to improve accessibility and provide a clearer description of the image content.

This update enhances the documentation by ensuring that visual elements are properly described, aiding users who rely on screen readers.at

* Add Scalekit dryrun documentation

- Introduced a new guide for the `scalekit-dryrun` CLI tool, detailing its usage for testing Scalekit authentication flows without writing code.
- Included prerequisites, step-by-step instructions for registering the redirect URI, running the CLI command, and reviewing authentication results.
- Explained the underlying authentication flow and common error scenarios to assist users in troubleshooting.
- Emphasized that `scalekit-dryrun` is intended for local testing only, ensuring users understand its limitations.

This addition enhances the Scalekit documentation by providing a practical tool for developers to verify their authentication setup before implementation.

* fix: enhance Pylon widget integration and session handling

- Added a new Pylon widget script to initialize the chat widget with user session data, improving user interaction.
- Implemented robust session validation and sanitization for user email and name to enhance security.
- Introduced a new API endpoint to fetch the email hash for identity verification, ensuring accurate user identification.
- Improved error handling during session parsing and wid…
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

tooling Purely tooling related change

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants