portercode 0.1.3 → 0.1.10

package/LICENSE

@@ -1,4 +1,4 @@
-PROPRIETARY SOFTWARE LICENSE WITH SHARED RIGHTS
+PROPRIETARY SOFTWARE LICENSE WITH RESTRICTED USE
 ================================================
 
 Copyright (c) 2025 Carlos Alexis Gomez Ruiz
@@ -79,22 +79,91 @@ shall be subject to the following terms:
      any authorization or license agreement.
 
 --------------------------------------------------------------------------------
-5. RESTRICTIONS FOR UNAUTHORIZED PARTIES
+5. PERSONAL AND NON-COMMERCIAL USE LICENSE
 --------------------------------------------------------------------------------
 
-Unless expressly authorized in writing by the Author, unauthorized parties
-may NOT:
+The Author grants to any person obtaining a copy of this Software a LIMITED,
+NON-EXCLUSIVE, NON-TRANSFERABLE license for PERSONAL AND NON-COMMERCIAL USE
+ONLY, subject to the following restrictions:
+
+5.1 PERMITTED USES:
+  a) Personal learning and education
+  b) Academic research and study
+  c) Non-commercial personal projects
+  d) Code review and security research (responsible disclosure)
+  e) Contributing improvements via pull requests (subject to section 4)
+
+5.2 PROHIBITED USES - General:
+  a) Any COMMERCIAL use, including but not limited to:
+     - Offering the Software as a service (SaaS)
+     - Integrating into commercial products or services
+     - Using in business operations or professional services
+     - Generating revenue directly or indirectly from the Software
+
+  b) CREATING COMPETING PRODUCTS OR SERVICES, including but not limited to:
+     - AI-powered coding assistants or CLI tools
+     - Developer productivity tools using LLM integration
+     - Code generation or editing tools
+     - Any product or service that competes with PorterCode
+     - Any product or service that competes with offerings from:
+       * Porter Metrics Inc.
+       * Companies affiliated with Carlos Alexis Gomez Ruiz
+       * Companies where Carlos Alexis Gomez Ruiz has ownership interest
+
+  c) REBRANDING, RESELLING, OR REDISTRIBUTION:
+     - Removing or altering copyright notices or attributions
+     - Distributing modified versions under a different name
+     - Selling or licensing the Software or derivatives
+     - Incorporating into products intended for distribution
+     - White-labeling or rebranding for any purpose
+
+  d) Reverse engineering, decompiling, or attempting to extract proprietary
+     algorithms, methodologies, or trade secrets with intent to replicate
+
+  e) Using the Software to train AI models or create training datasets
+     for competitive purposes
+
+  f) Circumventing or removing security features, license checks, or
+     usage limitations
+
+  g) Using the Software in any manner that violates applicable laws or
+     regulations
+
+5.3 SPECIFIC PROHIBITED COMPETITIVE USES:
+  You may NOT use this Software to create, develop, or operate:
+  - LLM-based coding assistants or development tools
+  - CLI tools for code generation or manipulation
+  - AI agents for software development
+  - Developer productivity platforms using AI
+  - Code editors with AI capabilities
+  - Automated programming or refactoring tools
+  - Developer workflow automation tools using LLM
+  - Any tool marketed as an alternative to PorterCode or similar products
+
+5.4 REQUIRED ATTRIBUTION:
+  - All redistributions (if permitted) must retain copyright notices
+  - Modified versions must clearly indicate changes made
+  - No use of Author's or Porter Metrics Inc.'s names for endorsement
 
-  a) Copy, reproduce, or duplicate the Software or any portion thereof
-  b) Modify, adapt, translate, or create derivative works based on the Software
-  c) Distribute, sublicense, lease, rent, loan, or transfer the Software
-  d) Reverse engineer, disassemble, decompile, or attempt to derive source code
-  e) Remove, alter, or obscure any proprietary notices on the Software
-  f) Use the Software for any unlawful purpose
-  g) Use the Software to develop competing products or services
+--------------------------------------------------------------------------------
+6. RESTRICTIONS FOR UNAUTHORIZED COMMERCIAL ENTITIES
+--------------------------------------------------------------------------------
+
+Unless expressly authorized in writing by the Author, commercial entities,
+organizations, or businesses may NOT:
+
+  a) Use the Software for any commercial purpose
+  b) Copy, reproduce, or duplicate the Software or any portion thereof
+  c) Modify, adapt, translate, or create derivative works based on the Software
+  d) Distribute, sublicense, lease, rent, loan, or transfer the Software
+  e) Integrate the Software into commercial products or services
+  f) Perform competitive analysis or benchmarking for commercial purposes
+
+Commercial entities seeking to use the Software must obtain explicit written
+permission and a separate commercial license from the Author.
 
 --------------------------------------------------------------------------------
-6. CONFIDENTIALITY
+7. CONFIDENTIALITY
 --------------------------------------------------------------------------------
 
 All parties with access to the Software acknowledge and agree that:
@@ -109,26 +178,75 @@ All parties with access to the Software acknowledge and agree that:
      effect indefinitely for trade secrets and for five (5) years for other
      Confidential Information.
 
+  d) Source code and internal documentation marked as confidential must not
+     be shared publicly or with unauthorized parties.
+
+--------------------------------------------------------------------------------
+8. TERMINATION
+--------------------------------------------------------------------------------
+
+8.1 AUTOMATIC TERMINATION:
+This license automatically terminates if you:
+  - Violate any term or restriction of this license
+  - Use the Software for any prohibited purpose
+  - Fail to comply with attribution requirements
+  - Attempt to create competing products or services
+  - Engage in any commercial use without authorization
+
+8.2 EFFECT OF TERMINATION:
+Upon termination:
+  - You must immediately cease all use of the Software
+  - Delete or destroy all copies in your possession
+  - Discontinue distribution of any derivatives
+  - Return or destroy all confidential materials
+
+8.3 SURVIVAL:
+Sections 1 (Ownership), 7 (Confidentiality), 9 (Disclaimer), 10 (Limitation
+of Liability), and 11 (Governing Law) survive termination.
+
 --------------------------------------------------------------------------------
-7. DISCLAIMER OF WARRANTIES
+9. DISCLAIMER OF WARRANTIES
 --------------------------------------------------------------------------------
 
 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. THE AUTHOR DOES NOT
-WARRANT THAT THE SOFTWARE WILL BE ERROR-FREE OR UNINTERRUPTED.
+WARRANT THAT THE SOFTWARE WILL BE ERROR-FREE, UNINTERRUPTED, SECURE, OR
+FREE OF HARMFUL COMPONENTS.
+
+YOU ASSUME ALL RISK ASSOCIATED WITH THE USE OF THIS SOFTWARE. THE AUTHOR
+SHALL NOT BE LIABLE FOR ANY DAMAGE TO YOUR COMPUTER SYSTEM, LOSS OF DATA,
+OR ANY OTHER DAMAGE RESULTING FROM USE OF THE SOFTWARE.
 
 --------------------------------------------------------------------------------
-8. LIMITATION OF LIABILITY
+10. LIMITATION OF LIABILITY
 --------------------------------------------------------------------------------
 
 IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
-CONSEQUENTIAL, OR PUNITIVE DAMAGES, INCLUDING BUT NOT LIMITED TO LOSS OF
-PROFITS, DATA, OR USE, ARISING OUT OF OR IN CONNECTION WITH THIS LICENSE
-OR THE SOFTWARE.
+CONSEQUENTIAL, EXEMPLARY, OR PUNITIVE DAMAGES, INCLUDING BUT NOT LIMITED TO:
+  - Loss of profits, revenue, or business opportunities
+  - Loss of data or data corruption
+  - Business interruption or downtime
+  - Cost of substitute products or services
+  - Loss of goodwill or reputation damage
+
+THIS LIMITATION APPLIES EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY
+OF SUCH DAMAGES. THE AUTHOR'S TOTAL LIABILITY SHALL NOT EXCEED THE AMOUNT
+PAID BY YOU FOR THE SOFTWARE (IF ANY).
+
+SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF CERTAIN
+DAMAGES, SO THE ABOVE LIMITATIONS MAY NOT APPLY TO YOU.
+
+--------------------------------------------------------------------------------
+11. EXPORT COMPLIANCE
+--------------------------------------------------------------------------------
+
+You agree to comply with all applicable export and import laws and regulations.
+You shall not export, re-export, or transfer the Software to prohibited
+countries or individuals under applicable laws.
 
 --------------------------------------------------------------------------------
-9. GOVERNING LAW AND JURISDICTION
+12. GOVERNING LAW AND JURISDICTION
 --------------------------------------------------------------------------------
 
 This License shall be governed by and construed in accordance with the laws
@@ -136,11 +254,35 @@ of the State of Delaware, United States of America, without regard to conflict
 of law principles. Any disputes arising under this License shall be resolved
 exclusively in the state or federal courts located in Delaware.
 
+Both parties consent to personal jurisdiction in Delaware and waive any
+objection to venue in such courts.
+
+--------------------------------------------------------------------------------
+13. SEVERABILITY
+--------------------------------------------------------------------------------
+
+If any provision of this License is held to be invalid or unenforceable, the
+remaining provisions shall continue in full force and effect, and the invalid
+provision shall be modified to the minimum extent necessary to make it valid
+and enforceable.
+
+--------------------------------------------------------------------------------
+14. ENTIRE AGREEMENT
+--------------------------------------------------------------------------------
+
+This License constitutes the entire agreement between you and the Author
+regarding the Software and supersedes all prior or contemporaneous
+communications, whether written or oral.
+
+This License may only be modified by a written amendment signed by the Author.
+No waiver of any provision shall constitute a waiver of any other provision
+or future waiver of the same provision.
+
 --------------------------------------------------------------------------------
-10. CONTACT INFORMATION
+15. CONTACT INFORMATION
 --------------------------------------------------------------------------------
 
-For licensing inquiries, permissions, or to report violations:
+For licensing inquiries, commercial use permissions, or to report violations:
 
   Carlos Alexis Gomez Ruiz
   Email: alexisg.0207@gmail.com
@@ -150,4 +292,15 @@ For licensing inquiries, permissions, or to report violations:
 
 ================================================================================
 
+IMPORTANT NOTICE:
+
+This is proprietary software. Unauthorized commercial use, redistribution,
+rebranding, or creation of competing products is strictly prohibited and may
+result in legal action.
+
+For commercial licensing options, please contact the Author at the email
+address provided above.
+
+================================================================================
+
 For third-party software notices and attributions, see the NOTICE file.

package/README.md

@@ -24,6 +24,9 @@ porter -c
 
 # Use specific model
 porter -m anthropic/claude-sonnet-4-20250514
+
+# Start HTTP server for VS Code extension
+porter --port 50123
 ```
 
 ## Commands
@@ -42,7 +45,66 @@ porter config       Show configuration
 | `-s, --session` | Continue specific session |
 | `-c, --continue` | Continue most recent session |
 | `-m, --model` | Model to use (provider/model) |
-| `-g, --gateway` | Enable Gateway server for VSCode |
+| `--port <number>` | Start HTTP server on specified port (for VS Code extension) |
+
+---
+
+## VS Code Extension Communication
+
+When started with `--port`, PorterCode runs an HTTP server for communication with the VS Code extension.
+
+### Architecture: HTTP + SSE
+
+- **HTTP REST API**: For requests (prompts, sessions, auth, permissions)
+- **SSE (Server-Sent Events)**: For real-time streaming responses
+
+### API Endpoints
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/health` | GET | Health check |
+| `/events` | GET | SSE stream for real-time events |
+| `/api/sessions` | GET | List all sessions |
+| `/api/sessions` | POST | Create a new session |
+| `/api/sessions/:id/messages` | GET | Get messages for a session |
+| `/api/prompt` | POST | Send a prompt to the LLM |
+| `/api/cancel` | POST | Cancel active generation |
+| `/api/permission` | POST | Respond to permission requests |
+| `/api/auth/status` | GET | Check authentication status |
+| `/api/auth/providers` | GET | List available LLM providers |
+| `/api/auth/credentials` | POST | Save API key credential |
+
+### SSE Events
+
+The `/events` endpoint streams the following event types:
+
+| Event | Description |
+|-------|-------------|
+| `heartbeat` | Keep-alive ping |
+| `message.start` | LLM generation started |
+| `message.delta` | Text content chunk |
+| `reasoning.delta` | Reasoning/thinking content chunk |
+| `message.complete` | LLM generation finished |
+| `tool.start` | Tool execution started |
+| `tool.complete` | Tool execution finished |
+| `permission.request` | Permission required for tool |
+| `session.updated` | Session metadata changed |
+
+### Example: Connecting to SSE
+
+```javascript
+const eventSource = new EventSource('http://localhost:50123/events');
+
+eventSource.addEventListener('message.delta', (e) => {
+  const data = JSON.parse(e.data);
+  console.log('Content:', data.content);
+});
+
+eventSource.addEventListener('tool.start', (e) => {
+  const data = JSON.parse(e.data);
+  console.log('Tool:', data.toolName);
+});
+```
 
 ---
 
@@ -158,6 +220,16 @@ npm deprecate portercode@0.1.1 "Critical bug, use 0.1.2"
 
 ---
 
+## Features
+
+- 🤖 **Multi-LLM Support**: Works with Anthropic Claude, OpenAI GPT, Google Gemini, and Groq
+- 🔐 **Granular Permissions**: Fine-grained control over file operations and command execution
+- 💬 **Interactive Sessions**: Save and resume conversations
+- ⚙️ **Configurable**: Hierarchical configuration system with JSONC support
+- 🔧 **Extensible Tools**: Read, write, edit files, execute commands, search code
+- 🎨 **Terminal UI**: Beautiful interactive interface built with Ink
+- 📡 **VS Code Integration**: HTTP + SSE server for VS Code extension
+
 ## Development
 
 ```bash
@@ -171,8 +243,35 @@ bun test
 bun run typecheck
 ```
 
+---
+
+## Configuration
+
+Create a `porter.jsonc` file in your project root or `~/.config/portercode/porter.jsonc` globally:
+
+```jsonc
+{
+  "model": "claude-sonnet-4",
+  "permission": {
+    "edit": "ask",      // Always ask before editing files
+    "bash": "auto"      // Execute commands automatically
+  }
+}
+```
+
+### Configuration Options
+
+| Option | Description | Values |
+|--------|-------------|--------|
+| `model` | Default LLM model | `claude-sonnet-4`, `gpt-4`, `gemini-pro`, etc. |
+| `permission.edit` | Permission for editing files | `ask`, `auto`, `deny` |
+| `permission.write` | Permission for creating files | `ask`, `auto`, `deny` |
+| `permission.bash` | Permission for shell commands | `ask`, `auto`, `deny` |
+
+---
+
 ## License
 
 Proprietary - See [LICENSE](LICENSE) for details.
 
-Copyright (c) 2025 Porter Metrics Inc. All rights reserved.
+Copyright (c) 2025 Carlos Alexis Gomez Ruiz. All rights reserved.

package/dist/auth/index.d.ts

@@ -42,6 +42,51 @@ export declare namespace Auth {
         key: string;
         token: string;
     }>;
+    const ServiceAccount: z.ZodObject<{
+        type: z.ZodLiteral<"service-account">;
+        serviceAccount: z.ZodObject<{
+            project_id: z.ZodString;
+            client_email: z.ZodString;
+            private_key: z.ZodString;
+            location: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            project_id: string;
+            client_email: string;
+            private_key: string;
+            location?: string | undefined;
+        }, {
+            project_id: string;
+            client_email: string;
+            private_key: string;
+            location?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: "service-account";
+        serviceAccount: {
+            project_id: string;
+            client_email: string;
+            private_key: string;
+            location?: string | undefined;
+        };
+    }, {
+        type: "service-account";
+        serviceAccount: {
+            project_id: string;
+            client_email: string;
+            private_key: string;
+            location?: string | undefined;
+        };
+    }>;
+    const PerplexityApiKey: z.ZodObject<{
+        type: z.ZodLiteral<"perplexity-api-key">;
+        apiKey: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "perplexity-api-key";
+        apiKey: string;
+    }, {
+        type: "perplexity-api-key";
+        apiKey: string;
+    }>;
     const Info: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         type: z.ZodLiteral<"oauth">;
         refresh: z.ZodString;
@@ -81,6 +126,49 @@ export declare namespace Auth {
         type: "wellknown";
         key: string;
         token: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"service-account">;
+        serviceAccount: z.ZodObject<{
+            project_id: z.ZodString;
+            client_email: z.ZodString;
+            private_key: z.ZodString;
+            location: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            project_id: string;
+            client_email: string;
+            private_key: string;
+            location?: string | undefined;
+        }, {
+            project_id: string;
+            client_email: string;
+            private_key: string;
+            location?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: "service-account";
+        serviceAccount: {
+            project_id: string;
+            client_email: string;
+            private_key: string;
+            location?: string | undefined;
+        };
+    }, {
+        type: "service-account";
+        serviceAccount: {
+            project_id: string;
+            client_email: string;
+            private_key: string;
+            location?: string | undefined;
+        };
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"perplexity-api-key">;
+        apiKey: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "perplexity-api-key";
+        apiKey: string;
+    }, {
+        type: "perplexity-api-key";
+        apiKey: string;
     }>]>;
     type Info = z.infer<typeof Info>;
     function get(providerID: string): Promise<{
@@ -96,6 +184,17 @@ export declare namespace Auth {
         type: "wellknown";
         key: string;
         token: string;
+    } | {
+        type: "service-account";
+        serviceAccount: {
+            project_id: string;
+            client_email: string;
+            private_key: string;
+            location?: string | undefined;
+        };
+    } | {
+        type: "perplexity-api-key";
+        apiKey: string;
     }>;
     function all(): Promise<Record<string, Info>>;
     function set(key: string, info: Info): Promise<void>;

package/dist/brand/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Brand Module
+ *
+ * Re-exports brand configuration from theme.ts for backward compatibility
+ */
+export { PRODUCT_NAME, PRODUCT_COMMAND, CONFIG_DIR, CONFIG_FILE, RULES_FILE, ENV_PREFIX, LOGO_SIMPLE, LOGO_EXTENDED, LOGO_ASCII, LOCAL_RULE_FILES, GLOBAL_RULE_FILES, DEFAULT_THEME, PRIMARY_COLOR, themes, getTheme, setTheme, getThemeNames, initTheme, } from "../theme";
+export type { Theme } from "../theme";