strands-shell 0.1.0__tar.gz

strands_shell-0.1.0/.cargo/config.toml

@@ -0,0 +1,4 @@
+# `cargo xtask <task>` runs the repo automation crate in ./xtask.
+# See `cargo xtask help` for available tasks.
+[alias]
+xtask = "run --package xtask --"

strands_shell-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,111 @@
+name: Bug Report
+description: Report a bug in Strands Shell
+title: "[BUG] "
+labels: ["triage"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report for Strands Shell!
+  - type: checkboxes
+    id: "checks"
+    attributes:
+      label: "Checks"
+      options:
+        - label: "I have updated to the latest minor and patch version of Strands Shell"
+          required: true
+        - label: "I have checked the documentation and this is not expected behavior"
+          required: true
+        - label: "I have searched [./issues](./issues?q=) and there are no duplicates of my issue"
+          required: true
+  - type: dropdown
+    id: binding
+    attributes:
+      label: Binding
+      description: Which Strands Shell binding are you using?
+      options:
+        - Python
+        - Node.js
+        - Rust
+        - WASM
+    validations:
+      required: true
+  - type: input
+    id: shell-version
+    attributes:
+      label: Strands Shell Version
+      description: Which version of Strands Shell are you using?
+      placeholder: e.g., 0.1.0
+    validations:
+      required: true
+  - type: input
+    id: runtime-version
+    attributes:
+      label: Language Runtime Version
+      description: Which version of Python, Node.js, Rust, or your WASM runtime are you using?
+      placeholder: e.g., Python 3.12.4, Node.js 20.17.0, Rust 1.79.0, or wasmtime 23.0.0
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: Operating System
+      description: Which operating system and architecture are you using?
+      placeholder: e.g., macOS 14.5 (arm64) or Ubuntu 22.04 (x86_64)
+    validations:
+      required: true
+  - type: dropdown
+    id: installation-method
+    attributes:
+      label: Installation Method
+      description: How did you install Strands Shell?
+      options:
+        - pip (strands-shell)
+        - npm (@strands-agents/shell)
+        - cargo (strands-shell)
+        - built from source
+        - other
+    validations:
+      required: true
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: Detailed steps to reproduce the behavior
+      placeholder: |
+        1. Code Snippet (Minimal reproducible example)
+        2. Install Strands Shell using...
+        3. Run the command...
+        4. See error...
+    validations:
+      required: true
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected Behavior
+      description: A clear description of what you expected to happen
+    validations:
+      required: true
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: Actual Behavior
+      description: What actually happened
+    validations:
+      required: true
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Any other relevant information, logs, screenshots, etc.
+  - type: textarea
+    id: possible-solution
+    attributes:
+      label: Possible Solution
+      description: Optional - If you have suggestions on how to fix the bug
+  - type: input
+    id: related-issues
+    attributes:
+      label: Related Issues
+      description: Optional - Link to related issues if applicable

strands_shell-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,12 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Strands Agents Support
+    # Only one repo has Discussions enabled; point users there.
+    url: https://github.com/strands-agents/sdk-python/discussions
+    about: Please ask and answer questions here
+  - name: Strands Agents Community
+    url: https://discord.gg/strands
+    about: Chat with the Strands team and community on Discord
+  - name: Strands Agents Documentation
+    url: https://strandsagents.com
+    about: Visit our documentation for help

strands_shell-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,54 @@
+name: Feature Request
+description: Suggest a new feature or enhancement for Strands Shell
+title: "[FEATURE] "
+labels: ["triage"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a new feature for Strands Shell!
+  - type: dropdown
+    id: binding
+    attributes:
+      label: Binding
+      description: Which Strands Shell binding is this feature for?
+      options:
+        - Python
+        - Node.js
+        - Rust
+        - WASM
+        - Shell core / Not binding-specific
+    validations:
+      required: true
+  - type: textarea
+    id: problem-statement
+    attributes:
+      label: Problem Statement
+      description: Describe the problem you're trying to solve. What is currently difficult or impossible to do?
+      placeholder: I would like Strands Shell to...
+    validations:
+      required: true
+  - type: textarea
+    id: proposed-solution
+    attributes:
+      label: Proposed Solution
+      description: Optional - Describe your proposed solution in detail. How would this feature work?
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use Case
+      description: Provide specific use cases for the feature. How would people use it?
+      placeholder: This would help with...
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives-solutions
+    attributes:
+      label: Alternatives Solutions
+      description: Optional - Have you considered alternative approaches? What are their pros and cons?
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Include any other context, screenshots, code examples, or references that might help understand the feature request.

strands_shell-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,41 @@
+## Description
+<!-- Provide a detailed description of the changes in this PR -->
+
+## Related Issues
+
+<!-- Link to related issues using #issue-number format -->
+
+## Documentation PR
+
+<!-- Link to any related documentation PR -->
+
+## Type of Change
+
+<!-- Choose one of the following types of changes, delete the rest -->
+
+Bug fix
+New feature
+Breaking change
+Documentation update
+Other (please describe):
+
+## Testing
+
+How have you tested the change? Verify that the changes do not break functionality or introduce new warnings.
+
+- [ ] I ran the relevant test suites for the bindings I touched (`cargo test --workspace --all-targets`, `pytest tests/python`, `npm test`)
+- [ ] If I touched Rust, I ran `cargo fmt` and `cargo clippy`
+
+## Checklist
+- [ ] I have read the CONTRIBUTING document
+- [ ] I have reviewed and understand every line of code in this PR, including any generated by AI tools, and I can explain why it works
+- [ ] My change is focused and reasonably small; I have split unrelated work into separate PRs
+- [ ] I have added any necessary tests that prove my fix is effective or my feature works
+- [ ] I have updated the documentation accordingly
+- [ ] I have added an appropriate example to the documentation to outline the feature, or no new docs are needed
+- [ ] My changes generate no new warnings
+- [ ] Any dependent changes have been merged and published
+
+----
+
+By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

strands_shell-0.1.0/.github/actions/stamp-version/action.yml

@@ -0,0 +1,62 @@
+name: Stamp version
+description: >-
+  Write the release version (derived from the git tag) into the package
+  manifests. The git tag is the single source of truth for the version; the
+  committed manifests carry a 0.0.0 placeholder and never hold a real version.
+  This action stamps the tag's version into Cargo.toml, pyproject.toml, and
+  package.json right after checkout, before the build tools (maturin / napi)
+  read them. Run it in every job that builds, packs, or publishes.
+
+# ── Why stamp at all (vs. committing the version) ───────────────────────────
+# Committing a concrete version in three manifests means three things to bump
+# in lockstep on every release, and they silently drift. Deriving from the tag
+# keeps one source of truth and makes "cut a vX.Y.Z tag" the entire release
+# action. (See the `version` job in release.yml, which parses + validates the
+# tag and passes it here.)
+#
+# ── Why a tiny perl edit and not a dedicated tool ───────────────────────────
+# - Cargo has no built-in "version from git tag". The official option is
+#   `cargo set-version` from the `cargo-edit` crate, but that means a
+#   `cargo install cargo-edit` step (network + ~30-60s) in every build job just
+#   to rewrite one line. The crate is not published to crates.io (we release to
+#   PyPI + npm only), so Cargo.toml's version exists solely to feed maturin's
+#   wheel metadata — not worth an extra toolchain dependency.
+# - The perl one-liner rewrites ONLY the first top-level `version = "..."` line
+#   (the [package] / [project] version). Dependency and path-dep versions
+#   (e.g. napi = { version = "3" }, the strands-shell-macros path dep) appear
+#   later and are left untouched. perl -i ships on both Linux and macOS GitHub
+#   runners, so it works across the whole build matrix.
+# - package.json uses npm's own `npm version` command (the official mechanism,
+#   matching the strands-agents golden path), not a regex.
+
+inputs:
+  version:
+    description: The version to stamp (no leading "v"), e.g. 0.2.0
+    required: true
+
+runs:
+  using: composite
+  steps:
+    - name: Stamp version into manifests
+      shell: bash
+      env:
+        V: ${{ inputs.version }}
+      run: |
+        set -euo pipefail
+        # Rewrite the first `version = "..."` in each TOML (the package version).
+        perl -i -pe 'if (!$done && /^version\s*=\s*"/) { s/"[^"]*"/"$ENV{V}"/; $done=1 }' Cargo.toml
+        perl -i -pe 'if (!$done && /^version\s*=\s*"/) { s/"[^"]*"/"$ENV{V}"/; $done=1 }' pyproject.toml
+        echo "Stamped version $V:"
+        echo "  Cargo.toml=$(grep -m1 '^version' Cargo.toml)"
+        echo "  pyproject.toml=$(grep -m1 '^version' pyproject.toml)"
+        # package.json via npm's official version command. This is only needed by
+        # the Node jobs; the Python build jobs (python-wheels/sdist) set up Python
+        # but not Node — and python-wheels runs in a manylinux container with no
+        # npm — so guard on npm being available and skip otherwise.
+        if command -v npm >/dev/null 2>&1; then
+          # --allow-same-version so re-runs against an already-stamped tree pass.
+          npm version "$V" --no-git-tag-version --allow-same-version >/dev/null
+          echo "  package.json=$(node -p "require('./package.json').version")"
+        else
+          echo "  package.json=skipped (npm not available — Python-only job)"
+        fi

strands_shell-0.1.0/.github/dependabot.yml

@@ -0,0 +1,89 @@
+version: 2
+updates:
+  - package-ecosystem: "cargo"
+    directory: "/"
+    schedule:
+      interval: "daily"
+    open-pull-requests-limit: 100
+    labels:
+      - "dependencies"
+      - "rust"
+    commit-message:
+      prefix: "ci(rust)"
+    cooldown:
+      default-days: 5
+      semver-major-days: 30
+      semver-minor-days: 7
+      semver-patch-days: 3
+    groups:
+      development-dependencies:
+        dependency-type: "development"
+        applies-to: version-updates
+      production-minor:
+        dependency-type: "production"
+        applies-to: version-updates
+        update-types:
+          - "minor"
+          - "patch"
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "daily"
+    open-pull-requests-limit: 100
+    labels:
+      - "dependencies"
+      - "python"
+    commit-message:
+      prefix: "ci(python)"
+    cooldown:
+      default-days: 5
+      semver-major-days: 30
+      semver-minor-days: 7
+      semver-patch-days: 3
+    groups:
+      dev-dependencies:
+        patterns:
+          - "pytest"
+          - "maturin"
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "daily"
+    open-pull-requests-limit: 100
+    labels:
+      - "dependencies"
+      - "node"
+    commit-message:
+      prefix: "ci(node)"
+    cooldown:
+      default-days: 5
+      semver-major-days: 30
+      semver-minor-days: 7
+      semver-patch-days: 3
+    groups:
+      development-dependencies:
+        dependency-type: "development"
+        applies-to: version-updates
+      production-minor:
+        dependency-type: "production"
+        applies-to: version-updates
+        update-types:
+          - "minor"
+          - "patch"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"
+    open-pull-requests-limit: 100
+    commit-message:
+      prefix: ci
+    cooldown:
+      default-days: 5
+      semver-major-days: 30
+      semver-minor-days: 7
+      semver-patch-days: 3
+    groups:
+      actions:
+        patterns:
+          - "*"
+        applies-to: version-updates

strands_shell-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,148 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+    types: [opened, synchronize, reopened, ready_for_review]
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  rust:
+    name: Rust (${{ matrix.os }})
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache cargo
+        uses: Swatinem/rust-cache@v2
+
+      - name: cargo test
+        run: cargo test --workspace --all-targets
+
+      - name: cargo doc
+        env:
+          RUSTDOCFLAGS: -D warnings
+        run: cargo doc --workspace --no-deps
+
+      # cargo fmt and cargo clippy are intentionally not gated here yet —
+      # see the cleanup follow-up. Add them back once the repo is clean.
+
+  python:
+    name: Python (${{ matrix.os }}, ${{ matrix.python }})
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache cargo
+        uses: Swatinem/rust-cache@v2
+        with:
+          key: py-${{ matrix.os }}-${{ matrix.python }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python }}
+
+      - name: Create virtualenv
+        run: python -m venv .venv
+
+      - name: Install build deps
+        run: .venv/bin/pip install maturin pytest
+
+      - name: Build and install wheel
+        run: .venv/bin/maturin develop --release
+
+      - name: pytest
+        run: .venv/bin/pytest tests/python -v
+
+  audit:
+    name: Security audit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache cargo
+        uses: Swatinem/rust-cache@v2
+        with:
+          key: audit
+
+      - name: cargo install cargo-audit
+        run: cargo install --locked cargo-audit
+
+      - name: cargo audit
+        # Surfaces RustSec advisories in CI output. Not a hard gate yet —
+        # transitive deps via reqwest/rustls carry advisories we haven't
+        # triaged. Flip continue-on-error off once the dep tree is clean.
+        run: cargo audit
+        continue-on-error: true
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: "20"
+
+      - name: npm audit (production)
+        # package-lock.json is gitignored, so generate an ephemeral lockfile
+        # for the audit (npm audit requires one).
+        run: |
+          npm install --package-lock-only
+          npm audit --omit=dev
+
+  node:
+    name: Node.js (${{ matrix.os }}, Node ${{ matrix.node }})
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        node: ["20", "22", "24"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache cargo
+        uses: Swatinem/rust-cache@v2
+        with:
+          key: node-${{ matrix.os }}-${{ matrix.node }}
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ matrix.node }}
+
+      - name: npm install
+        # package-lock.json is gitignored, so `npm ci` can't run; use install.
+        run: npm install
+
+      - name: napi build
+        run: npm run build:debug
+
+      - name: tsc typecheck (public .d.ts surface)
+        run: npm run typecheck
+
+      - name: npm test
+        run: npm test

strands_shell-0.1.0/.github/workflows/pr-title.yml

@@ -0,0 +1,36 @@
+name: PR Title Conventional Commits
+
+on:
+  pull_request:
+    branches: [main]
+    types: [opened, edited, synchronize, reopened]
+
+jobs:
+  validate-pr-title:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: read
+    steps:
+      - name: Check PR title follows conventional commits
+        uses: amannn/action-semantic-pull-request@v6
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          types: |
+            feat
+            fix
+            docs
+            refactor
+            perf
+            test
+            build
+            ci
+            chore
+            revert
+          requireScope: false
+          subjectPattern: ^[a-z].+$
+          subjectPatternError: |
+            The subject "{subject}" must start with a lowercase letter.
+          ignoreLabels: |
+            bot
+            dependencies