@qodo/sdk 0.10.0 → 0.11.1

package/dist/sdk/exit-expression.js

@@ -0,0 +1,35 @@
+import jmespath from 'jmespath';
+/**
+ * Evaluate a JMESPath exit expression against structured output.
+ *
+ * Returns `true` when the expression yields a truthy value, `false` otherwise.
+ * This is a pure library utility — it never calls `process.exit()`.
+ *
+ * @param structuredOutput - The structured output to evaluate against (object, JSON string, or nullish).
+ * @param expression - A JMESPath expression string.
+ * @returns `true` if the expression result is truthy, `false` otherwise.
+ * @throws {Error} If the JMESPath expression is invalid.
+ */
+export function evaluateExitExpression(structuredOutput, expression) {
+    if (structuredOutput == null)
+        return false;
+    let data = structuredOutput;
+    if (typeof data === 'string') {
+        try {
+            data = JSON.parse(data);
+        }
+        catch {
+            return false;
+        }
+    }
+    if (typeof data !== 'object' || data === null)
+        return false;
+    try {
+        const result = jmespath.search(data, expression);
+        return !!result;
+    }
+    catch (e) {
+        throw new Error(`Failed to evaluate exit expression "${expression}": ${e.message}`);
+    }
+}
+//# sourceMappingURL=exit-expression.js.map

package/dist/sdk/exit-expression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-expression.js","sourceRoot":"","sources":["../../src/sdk/exit-expression.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,gBAAyB,EAAE,UAAkB;IAClF,IAAI,gBAAgB,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAE3C,IAAI,IAAI,GAAY,gBAAgB,CAAC;IAErC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAE5D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACjD,OAAO,CAAC,CAAC,MAAM,CAAC;IAClB,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,uCAAuC,UAAU,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;AACH,CAAC"}

package/dist/sdk/trigger-context.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CI Trigger Context — auto-detects the CI provider and extracts
+ * trigger metadata (PR URL, branch, commit SHA, etc.) from environment
+ * variables.  Works across GitHub Actions, GitLab CI, Bitbucket
+ * Pipelines, Gerrit, and a generic fallback.
+ */
+export type CIProvider = 'github' | 'gitlab' | 'bitbucket' | 'gerrit' | 'unknown';
+export interface CITriggerContext {
+    provider: CIProvider;
+    event_name?: string;
+    pr_url?: string;
+    branch?: string;
+    base_branch?: string;
+    repo_url?: string;
+    commit_sha?: string;
+    tag?: string;
+}
+/**
+ * Auto-detect the CI provider and extract trigger context from environment
+ * variables.  Optional `overrides` are merged on top (non-undefined values
+ * win).
+ */
+export declare function resolveTriggerContext(overrides?: Partial<CITriggerContext>): CITriggerContext;
+//# sourceMappingURL=trigger-context.d.ts.map

package/dist/sdk/trigger-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-context.d.ts","sourceRoot":"","sources":["../../src/sdk/trigger-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,UAAU,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAgID;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAgB7F"}

package/dist/sdk/trigger-context.js

@@ -0,0 +1,136 @@
+/**
+ * CI Trigger Context — auto-detects the CI provider and extracts
+ * trigger metadata (PR URL, branch, commit SHA, etc.) from environment
+ * variables.  Works across GitHub Actions, GitLab CI, Bitbucket
+ * Pipelines, Gerrit, and a generic fallback.
+ */
+import { readFileSync } from 'node:fs';
+// ---- Provider resolvers (first match wins) ----
+function resolveGitHub() {
+    if (process.env.GITHUB_ACTIONS !== 'true')
+        return null;
+    const ctx = {
+        provider: 'github',
+        event_name: process.env.GITHUB_EVENT_NAME,
+        branch: process.env.GITHUB_HEAD_REF || process.env.GITHUB_REF_NAME,
+        base_branch: process.env.GITHUB_BASE_REF || undefined,
+        repo_url: process.env.GITHUB_SERVER_URL && process.env.GITHUB_REPOSITORY
+            ? `${process.env.GITHUB_SERVER_URL}/${process.env.GITHUB_REPOSITORY}`
+            : undefined,
+        commit_sha: process.env.GITHUB_SHA,
+    };
+    // Extract tag for release/tag events
+    const ref = process.env.GITHUB_REF ?? '';
+    if (ref.startsWith('refs/tags/')) {
+        ctx.tag = ref.replace('refs/tags/', '');
+    }
+    // Extract pr_url from the event payload JSON
+    const eventPath = process.env.GITHUB_EVENT_PATH;
+    if (eventPath) {
+        try {
+            const raw = readFileSync(eventPath, 'utf-8');
+            const event = JSON.parse(raw);
+            ctx.pr_url = event?.pull_request?.html_url ?? undefined;
+        }
+        catch {
+            // Ignore — file may not exist or be malformed
+        }
+    }
+    // Fallback for pr_url
+    if (!ctx.pr_url) {
+        ctx.pr_url = process.env.PR_URL || process.env.QODO_PR_URL || undefined;
+    }
+    return ctx;
+}
+function resolveGitLab() {
+    if (process.env.GITLAB_CI !== 'true')
+        return null;
+    const ctx = {
+        provider: 'gitlab',
+        event_name: process.env.CI_PIPELINE_SOURCE,
+        branch: process.env.CI_COMMIT_BRANCH || process.env.CI_MERGE_REQUEST_SOURCE_BRANCH_NAME,
+        base_branch: process.env.CI_MERGE_REQUEST_TARGET_BRANCH_NAME || undefined,
+        repo_url: process.env.CI_PROJECT_URL || undefined,
+        commit_sha: process.env.CI_COMMIT_SHA,
+    };
+    // Build MR URL
+    const mrIid = process.env.CI_MERGE_REQUEST_IID;
+    const projectUrl = process.env.CI_PROJECT_URL;
+    if (mrIid && projectUrl) {
+        ctx.pr_url = `${projectUrl}/-/merge_requests/${mrIid}`;
+    }
+    // Tag
+    if (process.env.CI_COMMIT_TAG) {
+        ctx.tag = process.env.CI_COMMIT_TAG;
+    }
+    return ctx;
+}
+function resolveBitbucket() {
+    if (!process.env.BITBUCKET_PIPELINE_UUID)
+        return null;
+    const ctx = {
+        provider: 'bitbucket',
+        branch: process.env.BITBUCKET_BRANCH,
+        repo_url: process.env.BITBUCKET_GIT_HTTP_ORIGIN || undefined,
+        commit_sha: process.env.BITBUCKET_COMMIT,
+    };
+    // Infer event_name from PR presence
+    const prId = process.env.BITBUCKET_PR_ID;
+    if (prId) {
+        ctx.event_name = 'pull_request';
+        const origin = process.env.BITBUCKET_GIT_HTTP_ORIGIN;
+        if (origin) {
+            ctx.pr_url = `${origin}/pull-requests/${prId}`;
+        }
+        ctx.base_branch = process.env.BITBUCKET_PR_DESTINATION_BRANCH || undefined;
+    }
+    // Tag
+    if (process.env.BITBUCKET_TAG) {
+        ctx.tag = process.env.BITBUCKET_TAG;
+    }
+    return ctx;
+}
+function resolveGerrit() {
+    if (!process.env.GERRIT_CHANGE_URL)
+        return null;
+    return {
+        provider: 'gerrit',
+        event_name: process.env.GERRIT_EVENT_TYPE,
+        pr_url: process.env.GERRIT_CHANGE_URL,
+        branch: process.env.GERRIT_BRANCH,
+        commit_sha: process.env.GERRIT_PATCHSET_REVISION,
+        repo_url: process.env.GERRIT_PROJECT
+            ? `${process.env.GERRIT_CHANGE_URL?.split('/c/')[0] ?? ''}/${process.env.GERRIT_PROJECT}`
+            : undefined,
+    };
+}
+function resolveFallback() {
+    return {
+        provider: 'unknown',
+        pr_url: process.env.PR_URL || process.env.QODO_PR_URL || undefined,
+        branch: process.env.BRANCH || process.env.QODO_BRANCH || undefined,
+        commit_sha: process.env.COMMIT_SHA || process.env.QODO_COMMIT_SHA || undefined,
+        repo_url: process.env.REPO_URL || process.env.QODO_REPO_URL || undefined,
+        tag: process.env.TAG || process.env.QODO_TAG || undefined,
+    };
+}
+// ---- Public API ----
+/**
+ * Auto-detect the CI provider and extract trigger context from environment
+ * variables.  Optional `overrides` are merged on top (non-undefined values
+ * win).
+ */
+export function resolveTriggerContext(overrides) {
+    const detected = resolveGitHub() ??
+        resolveGitLab() ??
+        resolveBitbucket() ??
+        resolveGerrit() ??
+        resolveFallback();
+    if (!overrides)
+        return detected;
+    return {
+        ...detected,
+        ...Object.fromEntries(Object.entries(overrides).filter(([, v]) => v !== undefined)),
+    };
+}
+//# sourceMappingURL=trigger-context.js.map

package/dist/sdk/trigger-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-context.js","sourceRoot":"","sources":["../../src/sdk/trigger-context.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qodo/sdk",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "Qodo SDK for building AI-powered agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,7 +18,8 @@
     "./package.json": "./package.json"
   },
   "bin": {
-    "qodo-install-skill": "./dist/bin/install-skill.js"
+    "qodo-install-skill": "./dist/bin/install-skill.js",
+    "qodo-sdk": "./dist/bin/run.js"
   },
   "files": [
     "dist",
@@ -43,7 +44,7 @@
     "node": ">=18"
   },
   "scripts": {
-    "build": "npm run clean && tsc && chmod +x dist/bin/install-skill.js",
+    "build": "npm run clean && tsc && chmod +x dist/bin/install-skill.js dist/bin/run.js",
     "dev": "tsc --watch",
     "clean": "rm -rf dist",
     "typecheck": "tsc --noEmit",