struai 0.0.1__tar.gz → 0.2.0__tar.gz

struai-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,58 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test-python:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.9', '3.10', '3.11', '3.12']
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check src/
+
+      - name: Type check
+        run: mypy src/struai/ --ignore-missing-imports
+        continue-on-error: true
+
+  test-node:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: js
+    strategy:
+      matrix:
+        node-version: ['18', '20', '22']
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build
+        run: npm run build
+
+      - name: Test
+        run: npm test
+        continue-on-error: true  # Tests not implemented yet

struai-0.2.0/.github/workflows/publish-npm.yml

@@ -0,0 +1,68 @@
+name: Publish npm Package
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - 'js/**'
+      - '.github/workflows/publish-npm.yml'
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: js
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build
+        run: npm run build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: npm-dist
+          path: js/dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    if: github.event_name == 'release' || github.ref == 'refs/heads/main'
+    defaults:
+      run:
+        working-directory: js
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: npm-dist
+          path: js/dist/
+
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

struai-0.2.0/.github/workflows/publish-python.yml

@@ -0,0 +1,54 @@
+name: Publish Python Package
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - 'src/**'
+      - 'pyproject.toml'
+      - '.github/workflows/publish-python.yml'
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install build tools
+        run: pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    if: github.event_name == 'release' || github.ref == 'refs/heads/main'
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: python-dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true

struai-0.2.0/.gitignore

@@ -0,0 +1,43 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.venv/
+venv/
+
+# JavaScript
+js/node_modules/
+js/dist/
+js/*.tsbuildinfo
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+
+# Environment
+.env
+.env.local
+*.pem

struai-0.2.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: struai
+Version: 0.2.0
+Summary: StruAI Drawing Analysis SDK - AI-powered construction drawing analysis
+Project-URL: Homepage, https://struai.com
+Project-URL: Documentation, https://docs.struai.com/python
+Project-URL: Repository, https://github.com/struai/struai-python
+Project-URL: Issues, https://github.com/struai/struai-python/issues
+Author-email: StruAI <support@struai.com>
+License-Expression: MIT
+Keywords: ai,cad,construction drawings,drawing analysis,knowledge graph,pdf,struai,structural engineering
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# StruAI Python SDK
+
+Official Python SDK for the StruAI Drawing Analysis API.
+
+## Installation
+
+```bash
+pip install struai
+```
+
+## Quick Start
+
+```python
+from struai import StruAI
+
+client = StruAI(api_key="sk-xxx")  # or set STRUAI_API_KEY env var
+
+# Optional: override base URL (http://localhost:8000 or http://localhost:8000/v1)
+client = StruAI(api_key="sk-xxx", base_url="http://localhost:8000")
+```
+
+## Tier 1: Raw Detection ($0.02/page)
+
+Fast geometric detection. Returns annotations in ~1-2 seconds.
+
+```python
+# Analyze a PDF page
+result = client.drawings.analyze("structural.pdf", page=4)
+
+print(f"Processed in {result.processing_ms}ms")
+print(f"Page size: {result.dimensions.width}x{result.dimensions.height}")
+
+# Access detected annotations
+for leader in result.annotations.leaders:
+    texts = [t.text for t in leader.texts_inside]
+    print(f"Leader at {leader.arrow_tip}: {', '.join(texts)}")
+
+for tag in result.annotations.section_tags:
+    label = tag.texts_inside[0].text
+    print(f"Section {label}, direction: {tag.direction}")
+
+# Retrieve/delete previous results
+drawing = client.drawings.get("drw_7f8a9b2c")
+client.drawings.delete("drw_7f8a9b2c")
+```
+
+## Tier 2: Graph + Search ($0.15/page)
+
+Full pipeline: detection → LLM enrichment → knowledge graph → semantic search.
+
+```python
+# Create a project
+project = client.projects.create(
+    name="Building A Structural",
+    description="96-page structural drawing set"
+)
+
+# Add sheets (async processing)
+job = project.sheets.add("structural.pdf", page=4)
+result = job.wait(timeout=120)  # Blocks until complete
+print(f"Created {result.entities_created} entities")
+
+# Semantic search
+results = project.search(
+    query="W12x26 beam connections at grid A",
+    limit=10,
+    include_graph_context=True
+)
+
+for hit in results.results:
+    print(f"{hit.entity.label}: {hit.score:.2f}")
+    if hit.graph_context:
+        for rel in hit.graph_context.relationships:
+            print(f"  - {rel.type}: {rel.fact}")
+
+# Natural language query
+answer = project.query("What beams connect to column C3?")
+print(answer.answer)
+print(f"Confidence: {answer.confidence:.0%}")
+
+# Browse entities
+entities = project.entities.list(type="Component", limit=50)
+entity = project.entities.get("ent_abc123")
+```
+
+## Async Support
+
+```python
+from struai import AsyncStruAI
+
+async with AsyncStruAI(api_key="sk-xxx") as client:
+    # Tier 1
+    result = await client.drawings.analyze("structural.pdf", page=4)
+
+    # Tier 2
+    project = await client.projects.create(name="Building A")
+    job = await project.sheets.add("structural.pdf", page=4)
+    result = await job.wait(timeout=120)
+    results = await project.search("W12x26 beam connections")
+```
+
+## Error Handling
+
+```python
+from struai import StruAI, AuthenticationError, RateLimitError, NotFoundError
+
+try:
+    result = client.drawings.analyze("plans.pdf", page=99)
+except AuthenticationError:
+    print("Invalid API key")
+except RateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after}s")
+except NotFoundError:
+    print("Resource not found")
+```
+
+## License
+
+MIT

struai-0.2.0/README.md

@@ -0,0 +1,119 @@
+# StruAI Python SDK
+
+Official Python SDK for the StruAI Drawing Analysis API.
+
+## Installation
+
+```bash
+pip install struai
+```
+
+## Quick Start
+
+```python
+from struai import StruAI
+
+client = StruAI(api_key="sk-xxx")  # or set STRUAI_API_KEY env var
+
+# Optional: override base URL (http://localhost:8000 or http://localhost:8000/v1)
+client = StruAI(api_key="sk-xxx", base_url="http://localhost:8000")
+```
+
+## Tier 1: Raw Detection ($0.02/page)
+
+Fast geometric detection. Returns annotations in ~1-2 seconds.
+
+```python
+# Analyze a PDF page
+result = client.drawings.analyze("structural.pdf", page=4)
+
+print(f"Processed in {result.processing_ms}ms")
+print(f"Page size: {result.dimensions.width}x{result.dimensions.height}")
+
+# Access detected annotations
+for leader in result.annotations.leaders:
+    texts = [t.text for t in leader.texts_inside]
+    print(f"Leader at {leader.arrow_tip}: {', '.join(texts)}")
+
+for tag in result.annotations.section_tags:
+    label = tag.texts_inside[0].text
+    print(f"Section {label}, direction: {tag.direction}")
+
+# Retrieve/delete previous results
+drawing = client.drawings.get("drw_7f8a9b2c")
+client.drawings.delete("drw_7f8a9b2c")
+```
+
+## Tier 2: Graph + Search ($0.15/page)
+
+Full pipeline: detection → LLM enrichment → knowledge graph → semantic search.
+
+```python
+# Create a project
+project = client.projects.create(
+    name="Building A Structural",
+    description="96-page structural drawing set"
+)
+
+# Add sheets (async processing)
+job = project.sheets.add("structural.pdf", page=4)
+result = job.wait(timeout=120)  # Blocks until complete
+print(f"Created {result.entities_created} entities")
+
+# Semantic search
+results = project.search(
+    query="W12x26 beam connections at grid A",
+    limit=10,
+    include_graph_context=True
+)
+
+for hit in results.results:
+    print(f"{hit.entity.label}: {hit.score:.2f}")
+    if hit.graph_context:
+        for rel in hit.graph_context.relationships:
+            print(f"  - {rel.type}: {rel.fact}")
+
+# Natural language query
+answer = project.query("What beams connect to column C3?")
+print(answer.answer)
+print(f"Confidence: {answer.confidence:.0%}")
+
+# Browse entities
+entities = project.entities.list(type="Component", limit=50)
+entity = project.entities.get("ent_abc123")
+```
+
+## Async Support
+
+```python
+from struai import AsyncStruAI
+
+async with AsyncStruAI(api_key="sk-xxx") as client:
+    # Tier 1
+    result = await client.drawings.analyze("structural.pdf", page=4)
+
+    # Tier 2
+    project = await client.projects.create(name="Building A")
+    job = await project.sheets.add("structural.pdf", page=4)
+    result = await job.wait(timeout=120)
+    results = await project.search("W12x26 beam connections")
+```
+
+## Error Handling
+
+```python
+from struai import StruAI, AuthenticationError, RateLimitError, NotFoundError
+
+try:
+    result = client.drawings.analyze("plans.pdf", page=99)
+except AuthenticationError:
+    print("Invalid API key")
+except RateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after}s")
+except NotFoundError:
+    print("Resource not found")
+```
+
+## License
+
+MIT

struai-0.2.0/js/.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+dist/
+*.tsbuildinfo

struai-0.2.0/js/README.md

@@ -0,0 +1,73 @@
+# StruAI JavaScript SDK
+
+Official JavaScript/TypeScript SDK for the StruAI Drawing Analysis API.
+
+See the [main README](../README.md) for Python examples.
+
+## Installation
+
+```bash
+npm install struai
+```
+
+## Quick Start
+
+```typescript
+import { StruAI } from 'struai';
+
+const client = new StruAI({ apiKey: 'sk-xxx' });
+
+// Optional: override base URL (http://localhost:8000 or http://localhost:8000/v1)
+const local = new StruAI({ apiKey: 'sk-xxx', baseUrl: 'http://localhost:8000' });
+```
+
+## Tier 1: Raw Detection ($0.02/page)
+
+```typescript
+// Analyze a PDF page
+const result = await client.drawings.analyze(file, { page: 4 });
+
+console.log(`Processed in ${result.processing_ms}ms`);
+
+for (const leader of result.annotations.leaders) {
+  const texts = leader.texts_inside.map(t => t.text).join(', ');
+  console.log(`Leader: ${texts}`);
+}
+```
+
+## Tier 2: Graph + Search ($0.15/page)
+
+```typescript
+// Create project
+const project = await client.projects.create({
+  name: 'Building A Structural',
+  description: '96-page structural drawing set'
+});
+
+// Add sheet (async processing)
+const job = await project.sheets.add(file, { page: 4 });
+const result = await job.wait({ timeout: 120000 });
+console.log(`Created ${result.entities_created} entities`);
+
+// Semantic search
+const results = await project.search('W12x26 beam connections', {
+  limit: 10,
+  includeGraphContext: true
+});
+
+for (const hit of results.results) {
+  console.log(`${hit.entity.label}: ${hit.score}`);
+}
+
+// Natural language query
+const answer = await project.query('What beams connect to column C3?');
+console.log(answer.answer);
+
+// Browse entities
+const entities = await project.entities.list({ type: 'Component', limit: 50 });
+const entity = await project.entities.get('ent_abc123');
+```
+
+## License
+
+MIT

struai-0.2.0/js/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "struai",
+  "version": "0.2.0",
+  "description": "StruAI Drawing Analysis SDK - AI-powered construction drawing analysis",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "test": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "struai",
+    "structural-engineering",
+    "construction-drawings",
+    "drawing-analysis",
+    "cad",
+    "pdf",
+    "ai",
+    "knowledge-graph"
+  ],
+  "author": "StruAI <support@struai.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bhoshaga/struai.git",
+    "directory": "js"
+  },
+  "homepage": "https://struai.com",
+  "bugs": {
+    "url": "https://github.com/bhoshaga/struai/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}