drift-lang 0.1.0__tar.gz

drift_lang-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Riley Coleman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

drift_lang-0.1.0/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.4
+Name: drift-lang
+Version: 0.1.0
+Summary: An intent-based language for agentic systems — write agents in English, run them as async Python.
+Author: Riley Coleman
+License: MIT
+Project-URL: Homepage, https://github.com/rileyq7/drift
+Project-URL: Repository, https://github.com/rileyq7/drift
+Project-URL: Issues, https://github.com/rileyq7/drift/issues
+Keywords: agents,llm,transpiler,dsl,ai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Compilers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == "mcp"
+Provides-Extra: dendric
+Requires-Dist: dendric; extra == "dendric"
+Requires-Dist: psycopg2-binary; extra == "dendric"
+Requires-Dist: pgvector; extra == "dendric"
+Requires-Dist: openai>=1.0; extra == "dendric"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Provides-Extra: all
+Requires-Dist: mcp>=1.0; extra == "all"
+Requires-Dist: dendric; extra == "all"
+Requires-Dist: psycopg2-binary; extra == "all"
+Requires-Dist: pgvector; extra == "all"
+Requires-Dist: openai>=1.0; extra == "all"
+Dynamic: license-file
+
+# Drift
+
+**An intent-based language for agentic systems.** Write your agent in English-shaped blocks, run it as async Python.
+
+```drift
+agent GrantChecker {
+  model: "claude-haiku"
+  budget: $0.10 per run
+
+  step assess(application: string) -> Decision {
+    let summary = summarize the application as string
+    let score = score eligibility from 1 to 10 as int
+
+    if confident<score> {
+      return Decision { approved: score > 7, summary: summary }
+    } else {
+      escalate to human review
+    }
+  }
+}
+```
+
+That's a full agent — model choice, budget, an intent verb (`summarize`), confidence-gated branching, structured return. The transpiler turns it into async Python that runs on Drift's thin runtime.
+
+## Install
+
+```bash
+pip install drift-lang
+```
+
+Optional extras:
+
+```bash
+pip install "drift-lang[mcp]"      # MCP tool support
+pip install "drift-lang[dendric]"  # Dendric memory backend
+pip install "drift-lang[all]"
+```
+
+## 30 seconds to your first agent
+
+```bash
+drift new hello
+cd hello
+drift run hello.drift --input '{"name":"Riley"}'
+```
+
+No API key required — Drift falls back to a mock provider so you see something work immediately. Drop an `ANTHROPIC_API_KEY` or `OPENAI_API_KEY` into `.env` to use a real model.
+
+## CLI
+
+```
+drift new <name>          Scaffold a starter project
+drift run <file.drift>    Transpile and execute
+drift check <file.drift>  Validate syntax
+drift transpile <file>    Emit Python (use -o to write to a file)
+drift lex / parse         Debug tooling
+```
+
+## What's in the language
+
+- **`agent`** — top-level unit. Has `model`, `budget`, `state`, `memory`, and `step`s.
+- **`step`** — typed sub-procedure. Body is a sequence of declarative statements.
+- **Intent verbs** — `summarize`, `extract`, `classify`, `translate`, `match`, `generate`, etc. Each one becomes a typed LLM call.
+- **`confident<T>`** — confidence-gated branching. Run the cheap path when sure, escalate when not.
+- **`model { … }`** — multi-provider routing with `prefer`, `fallback`, `upgrade when confidence < 0.7`, and `stream "fast" then "slow"`.
+- **`tool name from python|mcp|rest`** — declare external tools. MCP runs against the official SDK.
+- **`pipeline`** — composable flow with `->`, `=>`, `~>`, `|>` operators.
+- **`for each x in xs parallel`** — `asyncio.gather` underneath.
+- **`attempt / recover`** — structured error handling with retry, fail, and named arms.
+- **`memory`** — short-term scratchpad or durable backend (Dendric). `remember`, `recall`, `deja_vu`, `forget`.
+- **`define verb`** — extend the intent vocabulary with your own typed verbs.
+- **Cross-agent calls** — `OtherAgent.step(args)` just works.
+
+## Docs
+
+| File | For |
+|---|---|
+| [`LLM.md`](./LLM.md) | Coding agents (Claude, Cursor, Copilot) — complete reference for one-shot loading |
+| [`docs/language.md`](./docs/language.md) | Humans learning Drift |
+| [`docs/cookbook.md`](./docs/cookbook.md) | Copy-paste patterns |
+| [`docs/gotchas.md`](./docs/gotchas.md) | Common mistakes |
+
+## Examples
+
+See [`examples/`](./examples) for working `.drift` programs and their generated Python:
+
+- `hello.drift` — minimal agent
+- `confident_demo.drift` — `confident<T>` branching
+- `grant_checker.drift` — end-to-end intent + structured return
+- `inbox_sorter.drift` — `for each … parallel` triage
+- `grant_checker_with_memory.drift` — Dendric-backed long-term memory
+
+## Status
+
+Alpha — language surface is stable, runtime works, 344/344 tests passing. Voice primitives parse but adapters aren't wired yet. Type system beyond `confident<T>` is on the roadmap.
+
+## License
+
+MIT

drift_lang-0.1.0/README.md

@@ -0,0 +1,99 @@
+# Drift
+
+**An intent-based language for agentic systems.** Write your agent in English-shaped blocks, run it as async Python.
+
+```drift
+agent GrantChecker {
+  model: "claude-haiku"
+  budget: $0.10 per run
+
+  step assess(application: string) -> Decision {
+    let summary = summarize the application as string
+    let score = score eligibility from 1 to 10 as int
+
+    if confident<score> {
+      return Decision { approved: score > 7, summary: summary }
+    } else {
+      escalate to human review
+    }
+  }
+}
+```
+
+That's a full agent — model choice, budget, an intent verb (`summarize`), confidence-gated branching, structured return. The transpiler turns it into async Python that runs on Drift's thin runtime.
+
+## Install
+
+```bash
+pip install drift-lang
+```
+
+Optional extras:
+
+```bash
+pip install "drift-lang[mcp]"      # MCP tool support
+pip install "drift-lang[dendric]"  # Dendric memory backend
+pip install "drift-lang[all]"
+```
+
+## 30 seconds to your first agent
+
+```bash
+drift new hello
+cd hello
+drift run hello.drift --input '{"name":"Riley"}'
+```
+
+No API key required — Drift falls back to a mock provider so you see something work immediately. Drop an `ANTHROPIC_API_KEY` or `OPENAI_API_KEY` into `.env` to use a real model.
+
+## CLI
+
+```
+drift new <name>          Scaffold a starter project
+drift run <file.drift>    Transpile and execute
+drift check <file.drift>  Validate syntax
+drift transpile <file>    Emit Python (use -o to write to a file)
+drift lex / parse         Debug tooling
+```
+
+## What's in the language
+
+- **`agent`** — top-level unit. Has `model`, `budget`, `state`, `memory`, and `step`s.
+- **`step`** — typed sub-procedure. Body is a sequence of declarative statements.
+- **Intent verbs** — `summarize`, `extract`, `classify`, `translate`, `match`, `generate`, etc. Each one becomes a typed LLM call.
+- **`confident<T>`** — confidence-gated branching. Run the cheap path when sure, escalate when not.
+- **`model { … }`** — multi-provider routing with `prefer`, `fallback`, `upgrade when confidence < 0.7`, and `stream "fast" then "slow"`.
+- **`tool name from python|mcp|rest`** — declare external tools. MCP runs against the official SDK.
+- **`pipeline`** — composable flow with `->`, `=>`, `~>`, `|>` operators.
+- **`for each x in xs parallel`** — `asyncio.gather` underneath.
+- **`attempt / recover`** — structured error handling with retry, fail, and named arms.
+- **`memory`** — short-term scratchpad or durable backend (Dendric). `remember`, `recall`, `deja_vu`, `forget`.
+- **`define verb`** — extend the intent vocabulary with your own typed verbs.
+- **Cross-agent calls** — `OtherAgent.step(args)` just works.
+
+## Docs
+
+| File | For |
+|---|---|
+| [`LLM.md`](./LLM.md) | Coding agents (Claude, Cursor, Copilot) — complete reference for one-shot loading |
+| [`docs/language.md`](./docs/language.md) | Humans learning Drift |
+| [`docs/cookbook.md`](./docs/cookbook.md) | Copy-paste patterns |
+| [`docs/gotchas.md`](./docs/gotchas.md) | Common mistakes |
+
+## Examples
+
+See [`examples/`](./examples) for working `.drift` programs and their generated Python:
+
+- `hello.drift` — minimal agent
+- `confident_demo.drift` — `confident<T>` branching
+- `grant_checker.drift` — end-to-end intent + structured return
+- `inbox_sorter.drift` — `for each … parallel` triage
+- `grant_checker_with_memory.drift` — Dendric-backed long-term memory
+
+## Status
+
+Alpha — language surface is stable, runtime works, 344/344 tests passing. Voice primitives parse but adapters aren't wired yet. Type system beyond `confident<T>` is on the roadmap.
+
+## License
+
+MIT

drift_lang-0.1.0/drift/__init__.py

@@ -0,0 +1,2 @@
+"""Drift — An intent-based programming language for agentic systems."""
+__version__ = "0.1.0"