@neurocode-ai/web 1.18.8

package/src/content/docs/bs/network.mdx

@@ -0,0 +1,51 @@
+---
+title: Mreža
+description: Konfigurirajte proksije i prilagođene certifikate.
+---
+
+OpenCode podržava standardne proxy varijable okruženja i prilagođene certifikate za enterprise mrežna okruženja.
+
+## Proksi
+
+OpenCode poštuje standardne varijable proxy okruženja.
+
+```bash
+# HTTPS proxy (recommended)
+export HTTPS_PROXY=https://proxy.example.com:8080
+
+# HTTP proxy (if HTTPS not available)
+export HTTP_PROXY=http://proxy.example.com:8080
+
+# Bypass proxy for local server (required)
+export NO_PROXY=localhost,127.0.0.1
+```
+
+:::caution
+TUI komunicira sa lokalnim HTTP serverom. Morate zaobići proxy za ovu vezu kako biste spriječili petlje usmjeravanja.
+:::
+
+Možete konfigurirati port servera i naziv hosta koristeći [CLI flags](/docs/cli#run).
+
+### Autentikacija
+
+Ako vaš proxy zahtijeva osnovnu autentifikaciju, uključite vjerodajnice u URL.
+
+```bash
+export HTTPS_PROXY=http://username:password@proxy.example.com:8080
+```
+
+:::caution
+Izbjegavajte tvrdo kodiranje lozinki. Koristite varijable okruženja ili sigurno skladište vjerodajnica.
+:::
+
+Za proxy servere koji zahtijevaju naprednu autentifikaciju poput NTLM ili Kerberos, razmotrite LLM Gateway koji podržava vašu metodu autentifikacije.
+
+## Prilagođeni certifikati
+
+Ako vaše preduzeće koristi prilagođene CA-ove za HTTPS veze, konfigurirajte OpenCode da im vjeruje.
+
+```bash
+export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem
+```
+
+Ovo radi i za proxy veze i za direktan pristup API-ju.

package/src/content/docs/bs/permissions.mdx

@@ -0,0 +1,228 @@
+---
+title: Dozvole
+description: Kontrolirajte koje radnje zahtijevaju odobrenje za pokretanje.
+---
+
+OpenCode koristi `permission` konfiguraciju da odluči da li će se određena radnja pokrenuti automatski, zatražiti od vas ili biti blokirana.
+Od `v1.1.1`, naslijeđena `tools` logička konfiguracija je zastarjela i spojena je u `permission`. Stara `tools` konfiguracija je još uvijek podržana za kompatibilnost unatrag.
+
+---
+
+## Akcije
+
+Svako pravilo dozvole rješava jedno od:
+
+- `"allow"` — pokrenuti bez odobrenja
+- `"ask"` — upit za odobrenje
+- `"deny"` — blokiraj akciju
+
+---
+
+## Konfiguracija
+
+Dozvole možete postaviti globalno (sa `*`) i nadjačati određene alate.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "*": "ask",
+    "bash": "allow",
+    "edit": "deny"
+  }
+}
+```
+
+Također možete postaviti sve dozvole odjednom:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": "allow"
+}
+```
+
+---
+
+## Granularna pravila (sintaksa objekta)
+
+Za većinu dozvola, možete koristiti objekt za primjenu različitih radnji na osnovu unosa alata.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": {
+      "*": "ask",
+      "git *": "allow",
+      "npm *": "allow",
+      "rm *": "deny",
+      "grep *": "allow"
+    },
+    "edit": {
+      "*": "deny",
+      "packages/web/src/content/docs/*.mdx": "allow"
+    }
+  }
+}
+```
+
+Pravila se procjenjuju na osnovu podudaranja uzorka, pri čemu **pobjeđuje **poslednje odgovarajuće pravilo\*\_. Uobičajeni obrazac je da se prvo pravilo `"*"` stavi sveobuhvatno, a poslije njega konkretnija pravila.
+
+### Zamjenski znakovi
+
+Uzorci dozvola koriste jednostavno podudaranje zamjenskih znakova:
+
+- `*` odgovara nula ili više bilo kojeg znaka
+- `?` odgovara tačno jednom znaku
+- Svi ostali likovi se bukvalno podudaraju
+
+### Proširenje kućnog direktorija
+
+Možete koristiti `~` ili `$HOME` na početku obrasca da referencirate svoj početni direktorij. Ovo je posebno korisno za [`external_directory`](#external-directories) pravila.
+
+- `~/projects/*` -> `/Users/username/projects/*`
+- `$HOME/projects/*` -> `/Users/username/projects/*`
+- `~` -> `/Users/username`
+
+### Vanjski direktoriji
+
+Koristite `external_directory` da dozvolite pozive alata koji dodiruju putanje izvan radnog direktorija gdje je OpenCode pokrenut. Ovo se odnosi na bilo koji alat koji uzima putanju kao ulaz (na primjer `read`, `edit`, `glob`, `grep` i mnoge `bash` komande).
+Proširenje kuće (poput `~/...`) utiče samo na način na koji je obrazac napisan. Ne čini vanjsku stazu dijelom trenutnog radnog prostora, tako da staze izvan radnog direktorija i dalje moraju biti dozvoljene preko `external_directory`.
+Na primjer, ovo omogućava pristup svemu pod `~/projects/personal/`:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "external_directory": {
+      "~/projects/personal/**": "allow"
+    }
+  }
+}
+```
+
+Svaki direktorij koji je ovdje dozvoljen nasljeđuje iste zadane postavke kao trenutni radni prostor. Pošto je [`read` zadano na `allow`](#defaults), čitanje je također dozvoljeno za unose pod `external_directory` osim ako se ne poništi. Dodajte eksplicitna pravila kada bi alat trebao biti ograničen na ovim stazama, kao što je blokiranje uređivanja uz zadržavanje čitanja:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "external_directory": {
+      "~/projects/personal/**": "allow"
+    },
+    "edit": {
+      "~/projects/personal/**": "deny"
+    }
+  }
+}
+```
+
+Držite ovu listu fokusiranom na pouzdane putanje, a dodatna allow/deny pravila dodajte po potrebi za druge alate (npr. `bash`).
+
+## Dostupne dozvole
+
+Dozvole OpenCode su označene imenom alata, plus nekoliko sigurnosnih mjera:
+
+- `read` — čitanje datoteke (odgovara putanji datoteke)
+- `edit` — sve izmjene fajlova (pokriva `edit`, `write`, `patch`)
+- `glob` — globbiranje fajla (odgovara glob uzorku)
+- `grep` — pretraga sadržaja (podudara se sa regularnim izrazom)
+- `bash` — izvođenje komandi ljuske (podudara se s raščlanjenim komandama kao što je `git status --porcelain`)
+- `task` — pokretanje subagenta (odgovara tipu podagenta)
+- `skill` — učitavanje vještine (odgovara nazivu vještine)
+- `lsp` — pokretanje LSP upita (trenutno negranularno)
+- `webfetch` — dohvaćanje URL-a (odgovara URL-u)
+- `websearch` — pretraživanje weba (odgovara upitu)
+- `external_directory` — pokreće se kada alat dodirne staze izvan radnog direktorija projekta
+- `doom_loop` — aktivira se kada se isti poziv alata ponovi 3 puta sa identičnim unosom
+
+---
+
+## Zadane postavke
+
+Ako ništa ne navedete, OpenCode počinje od dozvoljenih zadanih vrijednosti:
+
+- Većina dozvola je zadana na `"allow"`.
+- `doom_loop` i `external_directory` zadano na `"ask"`.
+- `read` je `"allow"`, ali `.env` fajlovi su po defaultu odbijeni:
+
+```json title="opencode.json"
+{
+  "permission": {
+    "read": {
+      "*": "allow",
+      "*.env": "deny",
+      "*.env.*": "deny",
+      "*.env.example": "allow"
+    }
+  }
+}
+```
+
+---
+
+## Šta radi “Ask”
+
+Kada OpenCode zatraži odobrenje, korisničko sučelje nudi tri ishoda:
+
+- `once` — odobri samo ovaj zahtjev
+- `always` — odobri buduće zahtjeve koji odgovaraju predloženim obrascima (za ostatak trenutne OpenCode sesije)
+- `reject` — odbiti zahtjev
+  Skup obrazaca koje bi `always` odobrio pruža alat (na primjer, bash odobrenja obično stavljaju na bijelu listu sigurni prefiks komande kao što je `git status*`).
+
+---
+
+## Agenti
+
+Možete nadjačati dozvole po agentu. Dozvole agenta su spojene sa globalnom konfiguracijom, a pravila agenta imaju prednost. [Saznajte više](/docs/agents#permissions) o dozvolama agenta.
+:::note
+Pogledajte gornji odjeljak [Granularna pravila (sintaksa objekata)](#granular-rules-object-syntax) za detaljnije primjere podudaranja uzoraka.
+:::
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": {
+      "*": "ask",
+      "git *": "allow",
+      "git commit *": "deny",
+      "git push *": "deny",
+      "grep *": "allow"
+    }
+  },
+  "agent": {
+    "build": {
+      "permission": {
+        "bash": {
+          "*": "ask",
+          "git *": "allow",
+          "git commit *": "ask",
+          "git push *": "deny",
+          "grep *": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+Također možete konfigurirati dozvole agenta u Markdownu:
+
+```markdown title="~/.config/opencode/agents/review.md"
+---
+description: Code review without edits
+mode: subagent
+permission:
+  edit: deny
+  bash: ask
+  webfetch: deny
+---
+
+Only analyze code and suggest changes.
+```
+
+:::tip
+Koristite podudaranje uzoraka za naredbe s argumentima. `"grep *"` dozvoljava `grep pattern file.txt`, dok bi ga samo `"grep"` blokirao. Naredbe poput `git status` rade za zadano ponašanje, ali zahtijevaju eksplicitnu dozvolu (kao `"git status *"`) kada se prosljeđuju argumenti.
+:::

package/src/content/docs/bs/plugins.mdx

@@ -0,0 +1,371 @@
+---
+title: Dodaci
+description: Napišite vlastite dodatke za proširenje OpenCode.
+---
+
+Dodaci vam omogućavaju da proširite OpenCode spajanjem na različite događaje i prilagođavanjem ponašanja. Možete kreirati dodatke za dodavanje novih funkcija, integraciju sa eksternim uslugama ili izmenu zadanog ponašanja OpenCode.
+Za primjere, pogledajte [plugins](/docs/ecosystem#plugins) kreirane od strane zajednice.
+
+---
+
+## Korištenje dodatka
+
+Postoje dva načina za učitavanje dodataka.
+
+### Iz lokalnih datoteka
+
+Postavite JavaScript ili TypeScript datoteke u direktorij dodataka.
+
+- `.opencode/plugins/` - Dodaci na nivou projekta
+- `~/.config/opencode/plugins/` - Globalni dodaci
+  Datoteke u ovim direktorijumima se automatski učitavaju pri pokretanju.
+
+---
+
+### Iz npm-a
+
+Navedite npm pakete u vašoj konfiguracijskoj datoteci.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-helicone-session", "opencode-wakatime", "@my-org/custom-plugin"]
+}
+```
+
+Podržani su i regularni i npm paketi sa opsegom.
+Pregledajte dostupne dodatke u [ecosystem](/docs/ecosystem#plugins).
+
+---
+
+### Kako se instaliraju dodaci
+
+**npm dodaci** se instaliraju automatski pomoću Bun pri pokretanju. Paketi i njihove zavisnosti su keširani u `~/.cache/opencode/node_modules/`.
+**Lokalni dodaci** se učitavaju direktno iz direktorija dodataka. Da biste koristili vanjske pakete, morate kreirati `package.json` unutar svog konfiguracijskog direktorija (pogledajte [Zavisnosti](#dependencies)) ili objaviti dodatak na npm i [dodati ga u svoju konfiguraciju](/docs/config#plugins).
+
+---
+
+### Redoslijed učitavanja
+
+Dodaci se učitavaju iz svih izvora i svi zakačnjaci rade u nizu. Redoslijed učitavanja je:
+
+1. Globalna konfiguracija (`~/.config/opencode/opencode.json`)
+2. Konfiguracija projekta (`opencode.json`)
+3. Globalni direktorij dodataka (`~/.config/opencode/plugins/`)
+4. Direktorij dodataka projekta (`.opencode/plugins/`)
+   Duplicirani npm paketi sa istim imenom i verzijom se učitavaju jednom. Međutim, lokalni dodatak i npm dodatak sa sličnim nazivima se učitavaju odvojeno.
+
+---
+
+## Kreiranje dodatka
+
+Dodatak je **JavaScript/TypeScript modul** koji izvozi jedan ili više dodataka
+funkcije. Svaka funkcija prima objekt konteksta i vraća hooks objekt.
+
+---
+
+### Zavisnosti
+
+Lokalni dodaci i prilagođeni alati mogu koristiti vanjske npm pakete. Dodajte `package.json` u svoj konfiguracijski direktorij sa zavisnostima koje su vam potrebne.
+
+```json title=".opencode/package.json"
+{
+  "dependencies": {
+    "shescape": "^2.1.0"
+  }
+}
+```
+
+OpenCode pokreće `bun install` pri pokretanju da ih instalira. Vaši dodaci i alati ih zatim mogu uvesti.
+
+```ts title=".opencode/plugins/my-plugin.ts"
+import { escape } from "shescape"
+
+export const MyPlugin = async (ctx) => {
+  return {
+    "tool.execute.before": async (input, output) => {
+      if (input.tool === "bash") {
+        output.args.command = escape(output.args.command)
+      }
+    },
+  }
+}
+```
+
+---
+
+### Osnovna struktura
+
+```js title=".opencode/plugins/example.js"
+export const MyPlugin = async ({ project, client, $, directory, worktree }) => {
+  console.log("Plugin initialized!")
+
+  return {
+    // Hook implementations go here
+  }
+}
+```
+
+Funkcija dodatka prima:
+
+- `project`: Trenutne informacije o projektu.
+- `directory`: Trenutni radni direktorij.
+- `worktree`: Putanja git radnog stabla.
+- `client`: Opencode SDK klijent za interakciju sa AI.
+- `$`: Bun's [shell API](https://bun.com/docs/runtime/shell) za izvršavanje naredbi.
+
+---
+
+### Podrška za TypeScript
+
+Za TypeScript dodatke, možete uvesti tipove iz paketa dodataka:
+
+```ts title="my-plugin.ts" {1}
+import type { Plugin } from "@opencode-ai/plugin"
+
+export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree }) => {
+  return {
+    // Type-safe hook implementations
+  }
+}
+```
+
+---
+
+### Događaji
+
+Dodaci se mogu pretplatiti na događaje kao što je prikazano ispod u odjeljku Primjeri. Evo liste različitih dostupnih događaja.
+
+#### Komandni događaji
+
+- `command.executed`
+
+#### Događaji datoteka
+
+- `file.edited`
+- `file.watcher.updated`
+
+#### Instalacijski događaji
+
+- `installation.updated`
+
+#### LSP događaji
+
+- `lsp.client.diagnostics`
+- `lsp.updated`
+
+#### Događaji poruka
+
+- `message.part.removed`
+- `message.part.updated`
+- `message.removed`
+- `message.updated`
+
+#### Događaji dozvola
+
+- `permission.asked`
+- `permission.replied`
+
+#### Serverski događaji
+
+- `server.connected`
+
+#### Događaji sesije
+
+- `session.created`
+- `session.compacted`
+- `session.deleted`
+- `session.diff`
+- `session.error`
+- `session.idle`
+- `session.status`
+- `session.updated`
+
+#### Todo događaji
+
+- `todo.updated`
+
+#### Shell događaji
+
+- `shell.env`
+
+#### Događaji alata
+
+- `tool.execute.after`
+- `tool.execute.before`
+
+#### TUI događaji
+
+- `tui.prompt.append`
+- `tui.command.execute`
+- `tui.toast.show`
+
+---
+
+## Primjeri
+
+Evo nekoliko primjera dodataka koje možete koristiti za proširenje OpenCode.
+
+### Slanje obavještenja
+
+Pošaljite obavještenja kada se dogode određeni događaji:
+
+```js title=".opencode/plugins/notification.js"
+export const NotificationPlugin = async ({ project, client, $, directory, worktree }) => {
+  return {
+    event: async ({ event }) => {
+      // Send notification on session completion
+      if (event.type === "session.idle") {
+        await $`osascript -e 'display notification "Session completed!" with title "opencode"'`
+      }
+    },
+  }
+}
+```
+
+Koristimo `osascript` za pokretanje AppleScript-a na macOS-u. Ovdje ga koristimo za slanje obavještenja.
+:::note
+Ako alat dodatka koristi isto ime kao ugrađeni alat, alat dodatka ima prednost.
+:::
+
+---
+
+### .env zaštita
+
+Spriječite opencode da čita `.env` fajlove:
+
+```javascript title=".opencode/plugins/env-protection.js"
+export const EnvProtection = async ({ project, client, $, directory, worktree }) => {
+  return {
+    "tool.execute.before": async (input, output) => {
+      if (input.tool === "read" && output.args.filePath.includes(".env")) {
+        throw new Error("Do not read .env files")
+      }
+    },
+  }
+}
+```
+
+---
+
+### Ubacivanje varijabli okruženja
+
+Ubacite varijable okruženja u sva izvršavanja ljuske (AI alati i korisnički terminali):
+
+```javascript title=".opencode/plugins/inject-env.js"
+export const InjectEnvPlugin = async () => {
+  return {
+    "shell.env": async (input, output) => {
+      output.env.MY_API_KEY = "secret"
+      output.env.PROJECT_ROOT = input.cwd
+    },
+  }
+}
+```
+
+---
+
+### Prilagođeni alati
+
+Dodaci također mogu dodati prilagođene alate u opencode:
+
+```ts title=".opencode/plugins/custom-tools.ts"
+import { type Plugin, tool } from "@opencode-ai/plugin"
+
+export const CustomToolsPlugin: Plugin = async (ctx) => {
+  return {
+    tool: {
+      mytool: tool({
+        description: "This is a custom tool",
+        args: {
+          foo: tool.schema.string(),
+        },
+        async execute(args, context) {
+          const { directory, worktree } = context
+          return `Hello ${args.foo} from ${directory} (worktree: ${worktree})`
+        },
+      }),
+    },
+  }
+}
+```
+
+Pomoćnik `tool` kreira prilagođeni alat koji opencode može pozvati. Uzima funkciju Zod sheme i vraća definiciju alata sa:
+
+- `description`: Šta alat radi
+- `args`: Zod šema za argumente alata
+- `execute`: Funkcija koja se pokreće kada se pozove alat
+  Vaši prilagođeni alati će biti dostupni za opencode zajedno sa ugrađenim alatima.
+
+---
+
+### Bilježenje
+
+Koristite `client.app.log()` umjesto `console.log` za strukturirano bilježenje:
+
+```ts title=".opencode/plugins/my-plugin.ts"
+export const MyPlugin = async ({ client }) => {
+  await client.app.log({
+    body: {
+      service: "my-plugin",
+      level: "info",
+      message: "Plugin initialized",
+      extra: { foo: "bar" },
+    },
+  })
+}
+```
+
+Nivoi su: `debug`, `info`, `warn`, `error`. Pogledajte [SDK dokumentaciju](https://opencode.ai/docs/sdk) za detalje.
+
+### Kuke za sažimanje
+
+Prilagodite kontekst uključen kada se sesija zbije:
+
+```ts title=".opencode/plugins/compaction.ts"
+import type { Plugin } from "@opencode-ai/plugin"
+
+export const CompactionPlugin: Plugin = async (ctx) => {
+  return {
+    "experimental.session.compacting": async (input, output) => {
+      // Inject additional context into the compaction prompt
+      output.context.push(`
+## Custom Context
+
+Include any state that should persist across compaction:
+- Current task status
+- Important decisions made
+- Files being actively worked on
+`)
+    },
+  }
+}
+```
+
+`experimental.session.compacting` kuka se aktivira prije nego što LLM generira sažetak nastavka. Koristite ga za ubacivanje konteksta specifičnog za domenu koji bi zadani prompt za sažimanje propustio.
+Također možete u potpunosti zamijeniti prompt za sabijanje postavljanjem `output.prompt`:
+
+```ts title=".opencode/plugins/custom-compaction.ts"
+import type { Plugin } from "@opencode-ai/plugin"
+
+export const CustomCompactionPlugin: Plugin = async (ctx) => {
+  return {
+    "experimental.session.compacting": async (input, output) => {
+      // Replace the entire compaction prompt
+      output.prompt = `
+You are generating a continuation prompt for a multi-agent swarm session.
+
+Summarize:
+1. The current task and its status
+2. Which files are being modified and by whom
+3. Any blockers or dependencies between agents
+4. The next steps to complete the work
+
+Format as a structured prompt that a new agent can use to resume work.
+`
+    },
+  }
+}
+```
+
+Kada je `output.prompt` postavljen, on u potpunosti zamjenjuje zadani prompt za sažimanje. Niz `output.context` se zanemaruje u ovom slučaju.