Skip to main content

Imprints

Imprints: named bundles of library items an agent learns at once by installing them.

Access it as client.imprints on a Strongly client, or the same path on AsyncStrongly with await. All methods exist on both with identical signatures.

Quick start​

from strongly import Strongly

client = Strongly()

# List (auto-paginates as you iterate)
for imprint in client.imprints.list():
    print(imprint.id)

Methods​

Core​

list​

list() -> SyncPaginator[Pool]

List the imprints you may see, with their item counts.

create​

create(*, name: str, description: str | None = None) -> Pool

Create an imprint.

retrieve​

retrieve(imprint_id: str) -> Pool

Get an imprint with its contents, grouped by type.

delete​

delete(imprint_id: str) -> None

Delete an imprint; its items stay in the library and agents stop reading it.

Other​

add_item​

add_item(imprint_id: str, *, resource_type: str, resource_id: str) -> PoolItem

Add a library item you may change to an imprint; one already in it changes nothing.

Parameters

  • resource_type (str): memory, rules, skills, prompts, tasks, artifacts or preferences.

add_member​

add_member(resource_id: str, *, user_id: str, role: str) -> Permissions

Share the resource with a user.

Parameters

  • resource_id (str): The resource's id.
  • user_id (str): The user to share it with.
  • role (str): "editor" (use and change it) or "user" (use it only; types without a use-only tier, such as knowledge bases, take "editor" only).

install​

install(agent_id: str, imprint_id: str) -> Pool

Install an imprint on an agent, which then recalls its items (restart it to apply).

permissions​

permissions(resource_id: str) -> Permissions

Return who can reach the resource: its owner, members and their roles, and visibility.

Parameters

  • resource_id (str): The resource's id.

remove_item​

remove_item(imprint_id: str, *, resource_type: str, resource_id: str) -> None

Take an item out of an imprint; the item stays in the library.

remove_member​

remove_member(resource_id: str, user_id: str) -> None

Stop sharing the resource with a user.

Parameters

  • resource_id (str): The resource's id.
  • user_id (str): The user to stop sharing it with.

set_visibility​

set_visibility(resource_id: str, visibility: str) -> Permissions

Make the resource public (every user can find and use it) or private.

Parameters

  • resource_id (str): The resource's id.
  • visibility (str): "public" or "private".

uninstall​

uninstall(agent_id: str, imprint_id: str) -> None

Uninstall an imprint from an agent (restart it to apply).