Stub

Configuration

Stub source connector for testing purposes.

Generates deterministic test entities with configurable distribution and speed. No external API calls are made - all content is generated locally.

View Source Code

Explore the Stub connector implementation

Authentication

This connector uses a custom authentication configuration.

Authentication Configuration

Stub source authentication credentials schema.

The stub source doesn’t require real authentication. This config is a placeholder for consistency with other sources.

stub_key

strDefaults to stub

Placeholder field (any value works, stub source doesn’t require real authentication)

Configuration Options

The following configuration options are available for this connector:

Configuration Parameters

Stub source configuration schema for testing.

Configures the generation of deterministic test entities with various content sizes and types. Uses weighted distribution for entity type selection.

entity_count

intDefaults to 10

Total number of entities to generate

seed

intDefaults to 42

Random seed for reproducible content generation

generation_delay_ms

int0

Delay between entity generations in milliseconds (0 for no delay)

small_entity_weight

intDefaults to 30

Weight for small entities (~100-200 chars, like comments)

medium_entity_weight

intDefaults to 30

Weight for medium entities (~500-1000 chars, like tasks)

large_entity_weight

intDefaults to 10

Weight for large entities (~3000-5000 chars, like articles)

small_file_weight

intDefaults to 15

Weight for small file entities (~1-5 KB)

large_file_weight

intDefaults to 5

Weight for large file entities (~50-100 KB)

code_file_weight

intDefaults to 10

Weight for code file entities (~2-10 KB)

Data Models

The following data models are available for this connector:

StubContainerEntity

Container entity for organizing stub entities.

Acts as a parent breadcrumb for all generated stub entities, similar to how projects/workspaces work in real sources.

Field	Type	Description
container_id	str	Unique identifier for the stub container
container_name	str	Name of the stub container
description	str	Description of the stub container
created_at	Optional[datetime]	When the container was created
seed	int	Random seed used for content generation
entity_count	int	Total number of entities in this container

SmallStubEntity

Small stub entity (~100-200 chars).

Represents: Comments, notes, short messages.

Field	Type	Description
stub_id	str	Unique identifier for the stub entity
title	str	Title of the stub entity
content	str	Short content text (~100-200 chars)
author	str	Author of the content
tags	list[str]	Tags associated with this entity
created_at	Optional[datetime]	When the entity was created
modified_at	Optional[datetime]	When the entity was last modified
sequence_number	int	Sequence number for ordering

MediumStubEntity

Medium stub entity (~500-1000 chars).

Represents: Tasks, pages, documents.

Field	Type	Description
stub_id	str	Unique identifier for the stub entity
title	str	Title of the stub entity
description	str	Detailed description (~500-1000 chars)
status	str	Status of the entity
priority	str	Priority level
assignee	str	Person assigned to this entity
tags	list[str]	Tags associated with this entity
notes	str	Additional notes
created_at	Optional[datetime]	When the entity was created
modified_at	Optional[datetime]	When the entity was last modified
due_date	Optional[datetime]	Due date for the entity
sequence_number	int	Sequence number for ordering

LargeStubEntity

Large stub entity (~3000-5000 chars).

Represents: Long articles, wikis, rich content.

Field	Type	Description
stub_id	str	Unique identifier for the stub entity
title	str	Title of the stub entity
summary	str	Brief summary of the content
content	str	Full content text (~3000-5000 chars)
author	str	Author of the content
category	str	Category of the content
tags	list[str]	Tags associated with this entity
sections	list[str]	Section headings in the content
references	list[str]	References cited in the content
created_at	Optional[datetime]	When the entity was created
modified_at	Optional[datetime]	When the entity was last modified
published_at	Optional[datetime]	When the content was published
word_count	int	Word count of the content
sequence_number	int	Sequence number for ordering

SmallStubFileEntity

Small stub file entity (~1-5 KB).

Represents: Small text files, CSVs, config files.

Field	Type	Description
stub_id	str	Unique identifier for the stub file
file_name	str	Name of the file
description	str	Description of the file contents
file_extension	str	File extension
created_at	Optional[datetime]	When the file was created
modified_at	Optional[datetime]	When the file was last modified
sequence_number	int	Sequence number for ordering

LargeStubFileEntity

Large stub file entity (~50-100 KB).

Represents: PDFs, larger documents, reports.

Field	Type	Description
stub_id	str	Unique identifier for the stub file
file_name	str	Name of the file
description	str	Description of the file contents
file_extension	str	File extension
summary	str	Summary of the document
author	str	Author of the document
category	str	Category of the document
page_count	int	Estimated page count
created_at	Optional[datetime]	When the file was created
modified_at	Optional[datetime]	When the file was last modified
sequence_number	int	Sequence number for ordering

CodeStubFileEntity

Code stub file entity (~2-10 KB).

Represents: Python, JavaScript, and other source code files.

Field	Type	Description
stub_id	str	Unique identifier for the stub code file
file_name	str	Name of the code file
description	str	Description of what the code does
functions	list[str]	Function names defined in the file
classes	list[str]	Class names defined in the file
imports	list[str]	Import statements in the file
created_at	Optional[datetime]	When the file was created
modified_at	Optional[datetime]	When the file was last modified
sequence_number	int	Sequence number for ordering