verbiflow 0.1.1__tar.gz

verbiflow-0.1.1/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: verbiflow
+Version: 0.1.1
+Summary: Python SDK for Verbiflow Growth workflows
+Author: Verbiflow
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: playwright<2,>=1.48
+Provides-Extra: agents
+Requires-Dist: claude-agent-sdk<0.3,>=0.2.87; extra == "agents"
+Requires-Dist: openai-agents<1,>=0.17; extra == "agents"
+Provides-Extra: dev
+Requires-Dist: pytest<10,>=8; extra == "dev"
+Requires-Dist: pytest-asyncio<2,>=0.24; extra == "dev"
+Requires-Dist: ruff<1,>=0.8; extra == "dev"
+Requires-Dist: basedpyright<2,>=1.24; extra == "dev"
+
+# Verbiflow Python SDK
+
+Agent-native Python client for Verbiflow Growth workflows.
+
+```python
+import verbiflow as vf
+
+job = vf.rows.qualify(
+    [{"email": "a@example.com", "title": "VP Engineering"}],
+    rubric="Pass senior engineering and product leaders.",
+)
+print(job.job_id, job.artifact_id)
+```
+
+The SDK runs local row transforms in Python and sends provider/platform side
+effects through the Verbiflow Bridge API.
+
+First-class direct Bridge namespaces include `vf.session`, `vf.billing`,
+`vf.senders`, `vf.sequences`, and `vf.linkedin` for the server-backed operator
+paths.
+
+The public SDK is typed-only. Use namespaces such as `vf.sources.people`,
+`vf.enrichment`, `vf.sequences`, `vf.linkedin`, `vf.files`, and `vf.host`;
+there is no public `vf.tools` or MCP-shaped `growth_*` alias layer.

verbiflow-0.1.1/README.md

@@ -0,0 +1,24 @@
+# Verbiflow Python SDK
+
+Agent-native Python client for Verbiflow Growth workflows.
+
+```python
+import verbiflow as vf
+
+job = vf.rows.qualify(
+    [{"email": "a@example.com", "title": "VP Engineering"}],
+    rubric="Pass senior engineering and product leaders.",
+)
+print(job.job_id, job.artifact_id)
+```
+
+The SDK runs local row transforms in Python and sends provider/platform side
+effects through the Verbiflow Bridge API.
+
+First-class direct Bridge namespaces include `vf.session`, `vf.billing`,
+`vf.senders`, `vf.sequences`, and `vf.linkedin` for the server-backed operator
+paths.
+
+The public SDK is typed-only. Use namespaces such as `vf.sources.people`,
+`vf.enrichment`, `vf.sequences`, `vf.linkedin`, `vf.files`, and `vf.host`;
+there is no public `vf.tools` or MCP-shaped `growth_*` alias layer.

verbiflow-0.1.1/pyproject.toml

@@ -0,0 +1,74 @@
+[build-system]
+requires = ["setuptools>=69.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "verbiflow"
+version = "0.1.1"
+description = "Python SDK for Verbiflow Growth workflows"
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [{ name = "Verbiflow" }]
+license = { text = "MIT" }
+dependencies = [
+  "httpx>=0.27,<1",
+  "playwright>=1.48,<2",
+]
+
+[project.scripts]
+verbiflow = "verbiflow.cli:main"
+
+[project.optional-dependencies]
+agents = [
+  "claude-agent-sdk>=0.2.87,<0.3",
+  "openai-agents>=0.17,<1",
+]
+dev = [
+  "pytest>=8,<10",
+  "pytest-asyncio>=0.24,<2",
+  "ruff>=0.8,<1",
+  "basedpyright>=1.24,<2",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+verbiflow = [
+  "py.typed",
+  "assets/function_index.json",
+  "assets/contract_matrix.json",
+  "skill/SKILL.md",
+  "skill/agents/*.yaml",
+  "skill/assets/*.json",
+  "skill/references/*.md",
+  "skill/scripts/*.py",
+  "skill/tests/*.py",
+  "play_app/*.html",
+  "play_app/*.json",
+  "play_app/*.js",
+  "play_app/*.mjs",
+  "play_app/*.md",
+  "play_app/src/*.js",
+  "play_app/src/*.svelte",
+  "play_app/src/*.css",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.basedpyright]
+typeCheckingMode = "strict"
+pythonVersion = "3.11"
+reportMissingTypeStubs = false
+reportAny = false
+include = ["src/verbiflow"]
+exclude = ["src/verbiflow/skill"]

verbiflow-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

verbiflow-0.1.1/src/verbiflow/__init__.py

@@ -0,0 +1,299 @@
+from __future__ import annotations
+
+from importlib import metadata as importlib_metadata
+from typing import TYPE_CHECKING
+
+from . import copy as copy  # preload before namespace proxies install
+from . import local_store, log, play_scaffold, reports, scaffold, source_adapters, viz, workflows
+from .client import AsyncClient, Client
+from .errors import (
+    ApiError,
+    MissingConfigurationError,
+    PartialCreateError,
+    ValidationError,
+    VerbiflowError,
+)
+from .jobs import AsyncJobResult, JobResult
+from .metadata import function_index, help
+from .models import Artifact, ArtifactPage, ArtifactRow, FunctionMetadata, PendingJob
+from .rowset import (
+    PERSONAL_DOMAINS,
+    RowSet,
+    artifact_id,
+    col,
+    count,
+    email_domain,
+    from_records,
+    is_personal_domain,
+    is_personal_domain_value,
+    rows_to_csv,
+)
+
+if TYPE_CHECKING:
+    import httpx
+
+try:
+    __version__ = importlib_metadata.version("verbiflow")
+except importlib_metadata.PackageNotFoundError:
+    __version__ = "0.0.0+unknown"
+
+_default_client: Client | None = None
+
+
+class _DefaultNamespaceProxy:
+    def __init__(self, namespace: str) -> None:
+        self._namespace = namespace
+
+    def __getattr__(self, name: str) -> object:
+        return getattr(getattr(_get_default_client(), self._namespace), name)
+
+    def __repr__(self) -> str:
+        return f"<verbiflow.{self._namespace} lazy namespace>"
+
+
+def _get_default_client() -> Client:
+    global _default_client
+    if _default_client is None:
+        _default_client = Client()
+    return _default_client
+
+
+def _install_default_namespace_proxies() -> None:
+    global rows, artifacts, auth, capabilities, clay, copy, crunchbase, crm, domains, email
+    global files, host, inbox, integrations, jobs, sources, enrichment, sequences, senders, linkedin
+    global personalization, plays, session, billing, workspaces, web
+    rows = _DefaultNamespaceProxy("rows")
+    artifacts = _DefaultNamespaceProxy("artifacts")
+    auth = _DefaultNamespaceProxy("auth")
+    capabilities = _DefaultNamespaceProxy("capabilities")
+    clay = _DefaultNamespaceProxy("clay")
+    copy = _DefaultNamespaceProxy("copy")
+    crunchbase = _DefaultNamespaceProxy("crunchbase")
+    crm = _DefaultNamespaceProxy("crm")
+    domains = _DefaultNamespaceProxy("domains")
+    email = _DefaultNamespaceProxy("email")
+    files = _DefaultNamespaceProxy("files")
+    host = _DefaultNamespaceProxy("host")
+    inbox = _DefaultNamespaceProxy("inbox")
+    integrations = _DefaultNamespaceProxy("integrations")
+    jobs = _DefaultNamespaceProxy("jobs")
+    sources = _DefaultNamespaceProxy("sources")
+    enrichment = _DefaultNamespaceProxy("enrichment")
+    sequences = _DefaultNamespaceProxy("sequences")
+    senders = _DefaultNamespaceProxy("senders")
+    linkedin = _DefaultNamespaceProxy("linkedin")
+    personalization = _DefaultNamespaceProxy("personalization")
+    plays = _DefaultNamespaceProxy("plays")
+    session = _DefaultNamespaceProxy("session")
+    billing = _DefaultNamespaceProxy("billing")
+    workspaces = _DefaultNamespaceProxy("workspaces")
+    web = _DefaultNamespaceProxy("web")
+
+
+_install_default_namespace_proxies()
+
+
+def configure(
+    *,
+    base_url: str | None = None,
+    api_key: str | None = None,
+    org_id: str | None = None,
+    org_slug: str | None = None,
+    profile: str | None = None,
+    timeout: float = 60.0,
+    max_retries: int = 2,
+    transport: httpx.AsyncBaseTransport | None = None,
+) -> Client:
+    global \
+        _default_client, \
+        rows, \
+        artifacts, \
+        auth, \
+        capabilities, \
+        clay, \
+        copy, \
+        crunchbase, \
+        crm, \
+        domains, \
+        email
+    global files, host, inbox, integrations, jobs, sources, enrichment, sequences, senders, linkedin
+    global personalization, plays, session, billing, workspaces, web
+    _default_client = Client(
+        base_url=base_url,
+        api_key=api_key,
+        org_id=org_id,
+        org_slug=org_slug,
+        profile=profile,
+        timeout=timeout,
+        max_retries=max_retries,
+        transport=transport,
+    )
+    rows = _default_client.rows
+    artifacts = _default_client.artifacts
+    auth = _default_client.auth
+    capabilities = _default_client.capabilities
+    clay = _default_client.clay
+    copy = _default_client.copy
+    crunchbase = _default_client.crunchbase
+    crm = _default_client.crm
+    domains = _default_client.domains
+    email = _default_client.email
+    files = _default_client.files
+    host = _default_client.host
+    inbox = _default_client.inbox
+    integrations = _default_client.integrations
+    jobs = _default_client.jobs
+    sources = _default_client.sources
+    enrichment = _default_client.enrichment
+    sequences = _default_client.sequences
+    senders = _default_client.senders
+    linkedin = _default_client.linkedin
+    personalization = _default_client.personalization
+    plays = _default_client.plays
+    session = _default_client.session
+    billing = _default_client.billing
+    workspaces = _default_client.workspaces
+    web = _default_client.web
+    return _default_client
+
+
+__all__ = [
+    "ApiError",
+    "Artifact",
+    "ArtifactPage",
+    "ArtifactRow",
+    "AsyncClient",
+    "Client",
+    "FunctionMetadata",
+    "AsyncJobResult",
+    "JobResult",
+    "MissingConfigurationError",
+    "PartialCreateError",
+    "PendingJob",
+    "PERSONAL_DOMAINS",
+    "RowSet",
+    "ValidationError",
+    "VerbiflowError",
+    "artifacts",
+    "artifact_id",
+    "auth",
+    "billing",
+    "capabilities",
+    "clay",
+    "col",
+    "configure",
+    "copy",
+    "count",
+    "crunchbase",
+    "crm",
+    "domains",
+    "email",
+    "email_domain",
+    "enrichment",
+    "files",
+    "from_records",
+    "function_index",
+    "help",
+    "host",
+    "inbox",
+    "integrations",
+    "is_personal_domain",
+    "is_personal_domain_value",
+    "jobs",
+    "linkedin",
+    "log",
+    "local_store",
+    "personalization",
+    "play_scaffold",
+    "plays",
+    "rows",
+    "rows_to_csv",
+    "reports",
+    "scaffold",
+    "senders",
+    "sequences",
+    "session",
+    "sources",
+    "source_adapters",
+    "viz",
+    "workspaces",
+    "web",
+    "workflows",
+    "__version__",
+]
+
+
+# Mirror @sdk_function-synthesized docstrings from each AsyncXNamespace to its
+# matching sync wrapper so vf.<namespace>.<fn>.__doc__ surfaces the arguments,
+# intent, and category metadata that `verbiflow functions describe` returns.
+# Done here (instead of inside each namespace file) to avoid re-entrant imports
+# that crash when verbiflow.email is re-evaluated alongside Python's stdlib
+# email module.
+def _mirror_namespace_docstrings() -> None:
+    from .artifacts import ArtifactsNamespace, AsyncArtifactsNamespace
+    from .auth import AsyncAuthNamespace, AuthNamespace
+    from .billing import AsyncBillingNamespace, BillingNamespace
+    from .capabilities import AsyncCapabilitiesNamespace, CapabilitiesNamespace
+    from .clay import AsyncClayNamespace, ClayNamespace
+    from .crm import AsyncCrmNamespace, CrmNamespace
+    from .crunchbase import AsyncCrunchbaseNamespace, CrunchbaseNamespace
+    from .domains import AsyncDomainsNamespace, DomainsNamespace
+    from .email import AsyncEmailNamespace, EmailNamespace
+    from .enrichment import AsyncEnrichmentNamespace, EnrichmentNamespace
+    from .files import AsyncFilesNamespace, FilesNamespace
+    from .host import AsyncChromeHostNamespace, ChromeHostNamespace
+    from .inbox import AsyncInboxNamespace, InboxNamespace
+    from .integrations import AsyncIntegrationsNamespace, IntegrationsNamespace
+    from .jobs import AsyncJobsNamespace, JobsNamespace
+    from .linkedin import AsyncLinkedInNamespace, LinkedInNamespace
+    from .personalization import AsyncPersonalizationNamespace, PersonalizationNamespace
+    from .plays import (
+        AsyncPlaySchedulesNamespace,
+        AsyncPlaysNamespace,
+        PlaySchedulesNamespace,
+        PlaysNamespace,
+    )
+    from .registry import mirror_async_docstrings as _mirror
+    from .rows import AsyncRowsNamespace, RowsNamespace
+    from .senders import AsyncSendersNamespace, SendersNamespace
+    from .sequences import AsyncSequencesNamespace, SequencesNamespace
+    from .session import AsyncSessionNamespace, SessionNamespace
+    from .sources import AsyncPeopleSourcesNamespace, PeopleSourcesNamespace
+    from .web import AsyncWebNamespace, WebNamespace
+    from .workspaces import AsyncWorkspacesNamespace, WorkspacesNamespace
+
+    for sync_cls, async_cls in (
+        (ArtifactsNamespace, AsyncArtifactsNamespace),
+        (AuthNamespace, AsyncAuthNamespace),
+        (BillingNamespace, AsyncBillingNamespace),
+        (CapabilitiesNamespace, AsyncCapabilitiesNamespace),
+        (ClayNamespace, AsyncClayNamespace),
+        (CrunchbaseNamespace, AsyncCrunchbaseNamespace),
+        (CrmNamespace, AsyncCrmNamespace),
+        (DomainsNamespace, AsyncDomainsNamespace),
+        (EmailNamespace, AsyncEmailNamespace),
+        (EnrichmentNamespace, AsyncEnrichmentNamespace),
+        (FilesNamespace, AsyncFilesNamespace),
+        (ChromeHostNamespace, AsyncChromeHostNamespace),
+        (InboxNamespace, AsyncInboxNamespace),
+        (IntegrationsNamespace, AsyncIntegrationsNamespace),
+        (JobsNamespace, AsyncJobsNamespace),
+        (LinkedInNamespace, AsyncLinkedInNamespace),
+        (PersonalizationNamespace, AsyncPersonalizationNamespace),
+        (PlaysNamespace, AsyncPlaysNamespace),
+        (PlaySchedulesNamespace, AsyncPlaySchedulesNamespace),
+        (RowsNamespace, AsyncRowsNamespace),
+        (SendersNamespace, AsyncSendersNamespace),
+        (SequencesNamespace, AsyncSequencesNamespace),
+        (SessionNamespace, AsyncSessionNamespace),
+        (PeopleSourcesNamespace, AsyncPeopleSourcesNamespace),
+        (WebNamespace, AsyncWebNamespace),
+        (WorkspacesNamespace, AsyncWorkspacesNamespace),
+    ):
+        _mirror(sync_cls, async_cls)
+
+
+_mirror_namespace_docstrings()
+del _mirror_namespace_docstrings
+_install_default_namespace_proxies()
+del _install_default_namespace_proxies

verbiflow-0.1.1/src/verbiflow/_types.py

@@ -0,0 +1,34 @@
+from __future__ import annotations
+
+from collections.abc import Mapping, Sequence
+from typing import Any, TypeAlias, cast
+
+JsonScalar: TypeAlias = None | bool | int | float | str
+JsonValue: TypeAlias = JsonScalar | list["JsonValue"] | dict[str, "JsonValue"]
+JsonObject: TypeAlias = dict[str, JsonValue]
+JsonMapping: TypeAlias = Mapping[str, JsonValue]
+JsonSequence: TypeAlias = Sequence[JsonValue]
+
+
+def as_json_object(value: object, *, context: str) -> JsonObject:
+    if isinstance(value, dict):
+        mapping = cast(Mapping[Any, Any], value)
+        result: JsonObject = {}
+        for key, item in mapping.items():
+            if not isinstance(key, str):
+                raise TypeError(f"{context} contains a non-string key: {key!r}")
+            result[key] = as_json_value(item, context=context)
+        return result
+    raise TypeError(f"{context} must be a JSON object.")
+
+
+def as_json_value(value: object, *, context: str) -> JsonValue:
+    if value is None or isinstance(value, bool | int | float | str):
+        return value
+    if isinstance(value, list):
+        return [as_json_value(item, context=context) for item in cast(list[Any], value)]
+    if isinstance(value, tuple):
+        return [as_json_value(item, context=context) for item in cast(tuple[Any, ...], value)]
+    if isinstance(value, dict):
+        return as_json_object(cast(object, value), context=context)
+    raise TypeError(f"{context} contains non-JSON value {value!r}.")